https://github.com/birdhimself/astroneer-docker
A container (Docker) image for Astroneer Dedicated Server. Supports encryption as well as Intel/AMD and ARM CPUs.
https://github.com/birdhimself/astroneer-docker
arm64 astroneer astroneer-dedicated-server docker docker-image x86-64
Last synced: 5 months ago
JSON representation
A container (Docker) image for Astroneer Dedicated Server. Supports encryption as well as Intel/AMD and ARM CPUs.
- Host: GitHub
- URL: https://github.com/birdhimself/astroneer-docker
- Owner: birdhimself
- License: agpl-3.0
- Created: 2024-06-07T23:22:51.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-22T10:54:17.000Z (7 months ago)
- Last Synced: 2025-11-22T12:13:07.691Z (7 months ago)
- Topics: arm64, astroneer, astroneer-dedicated-server, docker, docker-image, x86-64
- Language: Shell
- Homepage:
- Size: 1.06 MB
- Stars: 10
- Watchers: 1
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Astroneer Dedicated Server (in a container)
[](https://hub.docker.com/r/whalybird/astroneer-server)
[](https://hub.docker.com/r/whalybird/astroneer-server)
[](https://github.com/birdhimself/astroneer-docker/actions/workflows/build-and-push.yml)
A docker image to run Astroneer Dedicated Server using a modified version of [AstroTuxLauncher](https://github.com/birdhimself/AstroTuxLauncher). The source code is [available on GitHub](https://github.com/birdhimself/astroneer-docker/).
**Supports encryption as well as Intel/AMD and ARM CPUs.**
## Compose
```yaml
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` | `chown`s 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](https://blog.astroneer.space/p/astroneer-dedicated-server-details/) 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:
```ini
[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:
```ini
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_