Docker

StarRupture Server Setup with Docker

Deploy a StarRupture dedicated server using Docker for easy management, updates, and portability.

Important Note

At no point during this configuration will you use the in-game Server Manager - trying to use it will generate an error. Always connect to your server using your WAN IP via the Join Server button.

1Install Docker

Install Docker and Docker Compose on your system.

# Install Docker (Ubuntu/Debian)
curl -fsSL https://get.docker.com | sh

# Add your user to the docker group
sudo usermod -aG docker $USER

# Install Docker Compose
sudo apt install docker-compose-plugin

# Verify installation
docker --version
docker compose version

2Create Directory Structure

Create directories for your server files and configuration.

# Create server directory
mkdir -p ~/starrupture-server/{config,saves}
cd ~/starrupture-server

3Set Up Passwords

Generate secure passwords using the official utility.

Visit starrupture-utilities.com/passwords
Generate both an Admin password and a Player Password
Save the files to your config directory:

# Create Password.json (paste admin password content)
nano ~/starrupture-server/config/Password.json

# Create PlayerPassword.json (paste player password content)
nano ~/starrupture-server/config/PlayerPassword.json

4Create DSSettings.txt

Create the server configuration file.

~/starrupture-server/config/DSSettings.txt

{
  "SessionName": "MySaveGame",
  "SaveGameInterval": "300",
  "StartNewGame": "false",
  "LoadSavedGame": "true",
  "SaveGameName": "AutoSave0.sav"
}

First Time Setup

For initial world creation, set "StartNewGame": "true" and "LoadSavedGame": "false". After creating and saving your world, revert these settings.

Use our Config Builder to generate a customized configuration.

5Create Docker Compose File

Create a Docker Compose file to manage your server container.

docker-compose.yml

version: '3.8'

services:
  starrupture:
    image: cm2network/steamcmd:root
    container_name: starrupture-server
    restart: unless-stopped
    ports:
      - "7777:7777/udp"
    volumes:
      - ./server:/home/steam/starrupture
      - ./config/DSSettings.txt:/home/steam/starrupture/DSSettings.txt
      - ./config/Password.json:/home/steam/starrupture/Password.json
      - ./config/PlayerPassword.json:/home/steam/starrupture/PlayerPassword.json
      - ./saves:/home/steam/starrupture/Saved/SaveGames
    environment:
      - STEAMAPPID=XXXXXX
    entrypoint: ["/bin/bash", "-c"]
    command:
      - |
        # Update/install server
        ./steamcmd.sh +force_install_dir /home/steam/starrupture +login anonymous +app_update $$STEAMAPPID validate +quit
        
        # Start server with Wine
        cd /home/steam/starrupture
        wine StarRuptureServerEOS.exe -Log -port=7777

Note

Replace XXXXXX with the StarRupture Dedicated Server Steam App ID when available. You may need to use a custom Docker image with Wine support.

6Start the Server

Use Docker Compose to start your server.

# Start the server
docker compose up -d

# View logs
docker compose logs -f

# Stop the server
docker compose down

# Restart the server
docker compose restart

7Update the Server

To update to the latest version:

# Stop the server
docker compose down

# Remove the container and pull updates
docker compose pull

# Start with fresh container
docker compose up -d

Connecting to Your Server

Once your server is running, connect using:

Join Server: Use your WAN IP and port (e.g., 123.45.67.89:7777)
Do NOT use "Manage Server" - this will cause errors
Find your IP: curl ifconfig.me