mornedhels/windrose-server repository overview

⁠Windrose-Dedicated-Server

Docker image for the game Windrose. The image is based on the steamcmd⁠ image and uses supervisor to handle startup, automatic updates and cleanup.

⁠Environment Variables

⁠Server Settings

⁠World Settings

⁠General Settings

⚠️: Work in Progress

⁠Additional Information

• During the update process, the container temporarily requires more disk space (up to 2x the game size).

⁠Hooks

The scripts will wait for the hook to resolve/return before continuing.

⚠️: Work in Progress

⁠Image Tags

⁠Ports (default)

Only needed if direct connection is set to true.

⁠Volumes

Note: By default the volumes are created with the UID and GID 4711 (that user should not exist). To change this, set the environment variables PUID and PGID.

⁠Recommended System Requirements

• CPU: >= 2 cores
• RAM: >= 8 GB
• Disk: >= 35 GB (preferably SSD)

Official Docs⁠

⁠Usage

⁠Docker

docker run -d --name windrose \
  --hostname windrose \
  --restart=unless-stopped \
  -p 7777:7777 \
  -p 7777:7777/udp \
  -v ./game:/opt/windrose \
  -e SERVER_NAME="Windrose Server" \
  -e UPDATE_CRON="*/30 * * * *" \
  -e PUID=4711 \
  -e PGID=4711 \
  mornedhels/windrose-server:latest

⁠Docker Compose

services:
  windrose:
    image: mornedhels/windrose-server:latest
    container_name: windrose
    hostname: windrose
    restart: unless-stopped
    stop_grace_period: 90s
    ports:
      - "7777:7777"
      - "7777:7777/udp"
    volumes:
      - ./game:/opt/windrose
    # only add ntsync device if your kernel supports it (6.14 or newer)
    devices:
      - /dev/ntsync:/dev/ntsync
    environment:
      - SERVER_NAME=Windrose Server
      - UPDATE_CRON=*/30 * * * *
      - PUID=4711
      - PGID=4711

Note: The volumes are created next to the docker-compose.yml file. If you want to create the volumes, in the default location (eg. /var/lib/docker) you can use the following compose file:

services:
  windrose:
    image: mornedhels/windrose-server:latest
    container_name: windrose
    hostname: windrose
    restart: unless-stopped
    stop_grace_period: 90s
    ports:
      - "7777:7777"
      - "7777:7777/udp"
    volumes:
      - game:/opt/windrose
    # only add ntsync device if your kernel supports it (6.14 or newer)
    devices:
      - /dev/ntsync:/dev/ntsync
    environment:
      - SERVER_NAME=Windrose Server
      - UPDATE_CRON=*/30 * * * *
      - PUID=4711
      - PGID=4711

volumes:
  game:

⁠Backup

The image includes a backup script that creates a zip file of the last saved game state. To enable backups, set the BACKUP_CRON environment variable. To limit the number of backups, set the BACKUP_MAX_COUNT environment variable.

To restore a backup, stop the server and simply extract the zip file to the savegame folder and start the server up again. If you want to keep the current savegame, make sure to make a backup before deleting or overwriting the files.

⁠Commands

• Force Update:

  docker compose exec windrose supervisorctl start windrose-force-update
  

  Copy
• Apply World Configuration: Selects the world referenced by WorldIslandId, applies the current WORLD_* variables, stops the server, runs the world-description updater, and restarts the server.

  docker compose exec windrose supervisorctl start windrose-world-update
  

  Copy
• Restart Windrose Server: (can be used for periodic restarts)

  docker compose exec windrose supervisorctl restart windrose-server
  

  Copy
• Get Invite Code:

  docker compose exec windrose windrose-invite-code
  

  Copy

⁠Known Issues

⁠Docker >= 29.4.2: wine: socket: Function not implemented

Docker 29.4.2+ updated its default seccomp profile to block AF_ALG sockets as a mitigation for CVE-2026-31431⁠ — a Linux kernel privilege escalation vulnerability. This breaks Wine/Proton which relies on these sockets.

For workarounds and mitigation strategies, see the official Docker blog post:
Mitigating CVE-2026-31431 (Copy Fail) in Docker Engine⁠