samuelt1/wayward repository overview

⁠Wayward Dedicated Server Docker

The repo can be found here: https://github.com/cutiepoka/wayward-docker⁠

A Docker container for running a Wayward dedicated server with full configuration support.

⁠Quick Start

docker build -t wayward-server .
docker run -d -p 38740:38740 \
  -e STEAM_USER="your_steam_username" \
  -e STEAM_PASS="your_steam_password" \
  wayward-server

⁠Configuration

All Wayward server options can be configured through environment variables. Variable names match the exact command-line parameter names found here: https://www.waywardgame.com/multiplayer⁠

⁠Steam Authentication

• STEAM_USER - Steam username (optional - tries anonymous first)
• STEAM_PASS - Steam password (optional - tries anonymous first)

⁠Switch Options (Boolean)

Set to "true" to enable, "false" or unset to use the default provided by wayward server:

⁠Value Options

These options accept specific values. If not set, Wayward uses its built-in defaults:

⁠Optional Parameters

Only added if the environment variable is set:

⁠Docker Compose Example

version: '3.8'
services:
  wayward:
    build: .
    ports:
      - "38740:38740"
    environment:
      - name=My Wayward Server
      - maxPlayers=16
      - difficulty=hardcore
      - pvp=true
      - backup=true
      - backupInterval=15
      - port=38740
    volumes:
      - wayward_saves:/home/steam/save
    restart: unless-stopped

volumes:
  wayward_saves:

⁠Advanced Configuration

⁠PVP Server Example

environment:
  - name=PVP Battle Server
  - pvp=true
  - difficulty=hardcore
  - maxPlayers=32
  - private=false

⁠Private Development Server

environment:
  - name=Dev Server
  - private=true
  - dev=true
  - maxPlayers=4
  - customMilestoneModifiersAllowed=true

⁠Backup-Enabled Server

environment:
  - backup=true
  - backupInterval=10
  - maxBackups=48

⁠Data Persistence

The server saves are stored in /home/steam/save inside the container. Mount this as a volume to persist your worlds:

-v wayward_saves:/home/steam/save

⁠Building

docker build -t wayward-server .

⁠Troubleshooting

⁠Common Issues

1. Server won't start: Check that the Steam update completed successfully in the logs
2. Authentication failures: Verify Steam credentials or try without them (anonymous)
3. Connection issues: Ensure the port is properly exposed and not blocked by firewalls

⁠Logs

View container logs to see server startup and any errors:

docker logs <container_name>

⁠References

• Wayward Multiplayer Guide⁠
• Wayward Steam Page⁠

⁠License

This Docker configuration is provided as-is. Wayward is a commercial game - you must own it to use this server.