Windrose dedicated server for Linux using Docker, SteamCMD and Wine.
5.1K
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.
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
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.
| Tag | Purpose |
|---|---|
v1.6.5 | Stable — recommended for production |
latest | Latest build — for testing |
staging | Wine Staging + winetricks prewarm — for Wine compatibility issues |
debug | Extra diagnostic tools inside image (strace, lsof, etc.) |
IMAGE_REPOSITORY=ghcr.io/uberdudepl/windrose-dedicated-server-docker
IMAGE_TAG=v1.6.5
| Component | Minimum |
|---|---|
| OS | Ubuntu 22.04+ / Debian 12+ |
| Docker | 24.x+ |
| Docker Compose | v2.x |
| RAM | 8 GB (16 GB recommended) |
| Disk | 8 GB free |
| Variable | Default | Description |
|---|---|---|
PUID | 1000 | Host user ID for mounted files |
PGID | 1000 | Host group ID for mounted files |
SERVER_NAME | empty | Server display name |
INVITE_CODE | empty | Player invite code (auto-generated if empty) |
SERVER_PASSWORD | empty | Leave empty for public server |
MAX_PLAYERS | 4 | Max simultaneous players |
UPDATE_ON_START | true | Run SteamCMD update on each start |
GENERATE_SETTINGS | true | Auto-patch ServerDescription.json from env |
NOTIFY_PROVIDER | empty | discord, gotify, both, or auto |
PORT | 7777 | Game port (UDP) |
QUERYPORT | 7778 | Query port (UDP) |
| Host path | Container path | Contents |
|---|---|---|
./data | /data | Server files, saves, config |
./steam-home | /home/steam | Wine prefix, SteamCMD cache |
./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
Preferred upgrade path:
./windrose update
Manual fallback (only if wrapper is unavailable):
docker compose pull
docker compose up -d
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.
Content type
Image
Digest
sha256:af3087143…
Size
1.1 GB
Last updated
about 1 month ago
docker pull uberdudepl/windrose-dedicated-server-docker