HUB
Sign inSign up

uberdudepl/windrose-dedicated-server-docker

By uberdudepl

•Updated about 1 month ago

Windrose dedicated server for Linux using Docker, SteamCMD and Wine.

Image
Developer tools
0

5.1K

uberdudepl/windrose-dedicated-server-docker repository overview

⁠Windrose Dedicated Server — Docker

Dockerized Windrose dedicated server for Linux using Wine and SteamCMD, with persistent saves, backups, diagnostics, and optional Discord/Gotify notifications.

No port forwarding required — players join via Invite Code from ServerDescription.json.


⁠Quick start

git clone https://github.com/UberDudePL/windrose-dedicated-server-docker.git
cd windrose-dedicated-server-docker
chmod +x ./windrose ./serverctl.sh
./windrose setup

Or manually:

cp .env.example .env
nano .env
docker compose pull
docker compose up -d

⁠Startup recovery

When UPDATE_ON_START=true and the server executable is missing after the SteamCMD update, startup preserves the app manifest when present and retries installation once. A failed recovery keeps any preserved manifest under /data/steamapps; saved worlds are not removed. Set UPDATE_ON_START=false to skip automatic recovery.

The Docker runtime uses /opt/windrose/scripts/entrypoint.sh and /opt/windrose/scripts/healthcheck.sh. Root-level compatibility wrappers have been removed.


⁠Image tags

TagPurpose
v1.6.5Stable — recommended for production
latestLatest build — for testing
stagingWine Staging + winetricks prewarm — for Wine compatibility issues
debugExtra diagnostic tools inside image (strace, lsof, etc.)
IMAGE_REPOSITORY=ghcr.io/uberdudepl/windrose-dedicated-server-docker
IMAGE_TAG=v1.6.5

⁠Requirements

ComponentMinimum
OSUbuntu 22.04+ / Debian 12+
Docker24.x+
Docker Composev2.x
RAM8 GB (16 GB recommended)
Disk8 GB free

⁠Key environment variables

VariableDefaultDescription
PUID1000Host user ID for mounted files
PGID1000Host group ID for mounted files
SERVER_NAMEemptyServer display name
INVITE_CODEemptyPlayer invite code (auto-generated if empty)
SERVER_PASSWORDemptyLeave empty for public server
MAX_PLAYERS4Max simultaneous players
UPDATE_ON_STARTtrueRun SteamCMD update on each start
GENERATE_SETTINGStrueAuto-patch ServerDescription.json from env
NOTIFY_PROVIDERemptydiscord, gotify, both, or auto
PORT7777Game port (UDP)
QUERYPORT7778Query port (UDP)

⁠Volumes

Host pathContainer pathContents
./data/dataServer files, saves, config
./steam-home/home/steamWine prefix, SteamCMD cache

⁠Useful commands

./windrose status          # Operator dashboard (players, backup age, health)
./windrose doctor          # Full host/runtime preflight checks
./windrose backup          # Create a timestamped save backup
./windrose switch          # Switch between worlds interactively
./windrose notify          # Start Discord/Gotify activity watcher
./windrose notify test     # Test notification backend
./windrose update          # Safe pull + recreate flow
./windrose diagnostics     # Create a diagnostics bundle

⁠Upgrade

Preferred upgrade path:

./windrose update

Manual fallback (only if wrapper is unavailable):

docker compose pull
docker compose up -d

⁠Proxmox note

If running inside a Proxmox VM or LXC, set CPU type to host in VM → Hardware → Processors.
The default kvm64 type omits instruction sets required by Wine.



⁠Support

Tag summary

Content type

Image

Digest

sha256:af3087143…

Size

1.1 GB

Last updated

about 1 month ago

docker pull uberdudepl/windrose-dedicated-server-docker