Skip to content

v1.6.0 — All hands on deck: smarter status and safer backups

Choose a tag to compare

@UberDudePL UberDudePL released this 30 Apr 22:18
· 16 commits to main since this release

⚓ Windrose Dedicated Server Docker v1.6.0

This release brings an operator-focused status dashboard, two new backup safety checks, and fixes for long-session player detection.


Changes

./windrose status — operator dashboard

  • Replaced raw docker ps output with a compact dashboard showing: container state, health, currently online players, last activity event timestamp, backup age, and notifier status.
  • Next Steps hints are shown automatically when something needs attention (stale backup, notifier not running, container unhealthy).
  • Player data is read directly from container logs — notify does not need to be running in the background.
  • Switched from --tail 4000 to --since 24h so players active for many hours are not missed in high-volume log environments.

./windrose activity status — preserved as diagnostic command

  • Shows matched event count, scanned line count, and the full untruncated player list. Useful for verifying the log parser is working correctly.
  • Accepts a custom line count: ./windrose activity status 8000.

backup.sh — online player guard

  • Backup is now aborted with a clear error if players are currently online, detected from the last 24 hours of container logs.
  • A notification is sent via Discord or Gotify (if configured) when backup is aborted.
  • Set BACKUP_SKIP_ONLINE_CHECK=true in .env to bypass (for maintenance windows).

backup.sh — disk space preflight

  • Before archiving, the script checks available disk space on the BACKUP_DIR filesystem.
  • Required space is estimated as 1.5× the data directory size plus a 2 GB safety margin.
  • Backup aborts with a clear error if space is insufficient.

Docs

  • World difficulty and persistence guidance (merged from PR #5).
  • Pre-push shell validation requirements added to contributing guidance.
  • All new env vars and behaviors documented in README.

New environment variables

Variable Default Description
BACKUP_SKIP_ONLINE_CHECK false Skip online player check before backup

Notification variables (NOTIFY_PROVIDER, DISCORD_WEBHOOK_URL, GOTIFY_URL, GOTIFY_TOKEN) are now also read by backup.sh directly from .env.


Notes

  • entrypoint.sh and healthcheck.sh in the repository root remain compatibility wrappers delegating to /opt/windrose/scripts/. They have not been removed yet. Do not reference them directly in custom scripts — use the canonical paths under /opt/windrose/scripts/ instead.
  • No changes to volumes, ports, or save data layout. Existing persistent data is fully compatible.

Upgrade

# 1. Pin the new version in .env
IMAGE_TAG=v1.6.0

# 2. Pull the new image
./windrose pull

# 3. Restart with updated image
./windrose update