Astroneer Dedicated Server (in a container)

A docker image to run Astroneer Dedicated Server using a modified version of AstroTuxLauncher. The source code is available on GitHub.

Supports encryption as well as Intel/AMD and ARM CPUs.

Compose

services:
  astroneer:
    image: ghcr.io/birdhimself/astroneer-server:latest
    restart: unless-stopped
    stdin_open: true
    tty: true
    ports:
      - 7777:7777/udp
    volumes:
      - ./saved:/astrotux/AstroneerServer/Astro/Saved

Configuration

Environment

Variable	Description	Default
DEBUG	Enables debug logging	false
DISABLE_ENCRYPTION	Disables connection encryption	false
CREATE_LAUNCHER_CONFIG	Recreate the launcher.toml config every time the container starts	true
FORCE_CHOWN	chowns the astrotux folder on startup; potential workaround for an issue	false

Server settings

Most server settings can be found in the AstroServerSettings.ini file inside the ./saved/Config/WindowsServer folder (assuming it's configured as per the example compose.yml above). It's recommended to stop the server (docker compose stop) before editing this file to make sure it's not overwritten the next time the server shuts down.

I'm not listing all settings here (but be sure to check this post on the official Astroneer blog for more information), but some of the more interesting ones are:

Key	Description
ServerName	Name of the server in the server list
ServerPassword	If set, this password is required to join the server
ActiveSaveFileDescriptiveName	Name of the active savegame; can be changed to create a new save or load an existing one

Variants

Registries

The image is available from both ghcr.io and docker.io:

Registry	Full image name
ghcr.io	ghcr.io/birdhimself/astroneer-server
docker.io	docker.io/whalybird/astroneer-server

Available tags

Tag	Description
latest	Latest version for general use. Recommended in most cases.
experimental	Version with experimental features and changes. Will eventually become latest.

Architectures

This image supports both amd64 (Intel/AMD CPUs) and arm64 (e.g. Raspberry Pi, Apple) architectures. The correct image variant should be pulled automatically.

Encryption support

As of Wine 10.6 and GnuTLS 3.8.3, server encryption is supported. If you don't want to use encryption, you can disable it by setting DISABLE_ENCRYPTION=true in your compose.yml.

Interacting with the AstroTuxLauncher console

You can interact with the console by using docker compose attach astroneer. Detach using CTRL+p + CTRL+q, using CTRL+c will shutdown the server.

Configuring clients (if encryption is disabled)

Should you choose to disable encryption, clients will need to be configured accordingly.

To disable encryption, you need to edit the file Engine.ini located in %localappdata%\Astro\Saved\Config\WindowsNoEditor. Make sure the game isn't running and add the following lines to the file:

[SystemSettings]
net.AllowEncryption=False

Making yourself admin

Shutdown the server (docker compose stop) and edit the file AstroServerSettings.ini located in ./saved/Config/WindowsServer. Change the value of OwnerName to your Steam name and make sure OwnerGuid is set to 0. It should look like this:

OwnerName=My Steam Username
OwnerGuid=0

Start the server and make sure you join it before anyone else, as the game will automatically assign the admin/owner role to the first player joining.

If you can't progress past the first mission

If you can't progress past the first mission, you have to start a new game via the "Server admin" tab after connecting to the server. Click on "Manage game session" followed by "Start a new game" (and confirm by clicking "Start a new game" in the popout):

Server admin > Manage game session

Start a new game > Start a new game