ludix0/solace_crafting

By ludix0

•Updated 7 days ago

Dockerized dedicated server for Solace Crafting, auto-updated via SteamCMD.

Image

1.8K

Overview Tags

ludix0/solace_crafting repository overview

⁠Solace Crafting — Dedicated Server (Docker)

🇬🇧 English⁠ | 🇫🇷 Français⁠

⁠English

Docker container to host a Solace Crafting dedicated server (SteamCMD App ID 1086950). The server binary and dependencies are downloaded automatically via SteamCMD, running as an unprivileged user (steam, with configurable UID/GID).

Docker Hub image: ludix0/solace_crafting⁠
Ports used: 27015/tcp (game port), 27016/udp (Steam query port), 5055/tcp (additional port)

⁠Requirements

Docker + Docker Compose
A few GB of free disk space for SteamCMD and the game server files
If the server must be reachable from the internet, forward the ports below on your router (this game server is intended for the "Jeux vidéo" network in an isolated homelab setup)

⁠Method 1 — Quick install from Docker Hub (recommended)

mkdir -p ~/solace_crafting && cd ~/solace_crafting

Create a docker-compose.yml:

services:
  solace-server:
    image: ludix0/solace_crafting:latest
    container_name: solace_crafting
    restart: unless-stopped
    ports:
      - "7777:27015/tcp"
      - "27016:27016/udp"
      - "7775:5055/tcp"
    environment:
      - TZ=Europe/Paris
      - PUID=1000
      - PGID=1000
      - UPDATE_ON_START=true
      - SERVER_NAME=My-Solace-Server
      - DESCRIPTION=My dedicated server.
      - SERVER_PORT=27015
      - STEAMQUERYPORT=27016
      - PASSWORD=
      - MAX_PLAYERS=10
      - ALLOWADMIN=false
      - ADMINPASSWORD=
      - WORLD_NAME=Gaia
    volumes:
      - ./volumes/filesServer:/home/steam/solace_server
      - ./volumes/steamcmd:/home/steam/steamcmd
      - "./volumes/config_files:/home/steam/.config/unity3d/Big Kitty Games/Solace Crafting"

docker compose up -d
docker compose logs -f

⁠Method 2 — Build from source (GitHub)

git clone https://github.com/Ludix0/solace_crafting.git
cd solace_crafting
ln -sf /path/to/your/secrets.env .env   # or create a .env with the variables below
docker build -t ludix0/solace_crafting:latest .
docker compose up -d

⁠Environment variables

Variable	Required	Description
`PUID`	No (default `1000`)	UID the `steam` user runs as inside the container
`PGID`	No (default `1000`)	GID the `steam` user runs as inside the container
`SERVER_NAME`	No (default `MonServeurSolace`)	Server name shown in the server browser
`DESCRIPTION`	No	Server description shown in `servercfg.dat`
`WORLD_NAME`	No (default `World1`)	Name of the world save to use (`worldSaveToUse`)
`SERVER_PORT`	No (default `27015`)	Game port used by the server
`STEAMQUERYPORT`	No	Steam query port; should match the exposed/mapped UDP port
`PASSWORD`	No (default empty = public server)	Server join password; if set, the server is marked private
`MAX_PLAYERS`	No (default `10`)	Maximum number of concurrent players
`ALLOWADMIN`	No	Enables the admin password (`true`/`false`)
`ADMINPASSWORD`	No	Admin password, used only if `ALLOWADMIN=true`
`UPDATE_ON_START`	No	If `true`, SteamCMD updates/validates the server on every container start; otherwise it only installs on first run (when the server binary is missing)
`TZ`	No	Container timezone

⁠Volumes

Volume	Content
`/home/steam/solace_server`	Game server binaries and files, downloaded/updated by SteamCMD (App ID `1086950`)
`/home/steam/steamcmd`	SteamCMD installation
`/home/steam/.config/unity3d/Big Kitty Games/Solace Crafting`	Unity server config folder, including the generated `servercfg.dat` and world saves

⁠Ports

Port	Protocol	Usage
`27015`	TCP	Main game port (`SERVER_PORT`)
`27016`	UDP	Steam query port (`STEAMQUERYPORT`)
`5055`	TCP	Additional port mapped by the container (not further documented in the source files)

⁠Français

Conteneur Docker pour héberger un serveur dédié Solace Crafting (SteamCMD App ID 1086950). Le binaire du serveur et ses dépendances sont téléchargés automatiquement via SteamCMD, en s'exécutant avec un utilisateur non privilégié (steam, avec UID/GID configurables).

Image Docker Hub : ludix0/solace_crafting⁠
Ports utilisés : 27015/tcp (port de jeu), 27016/udp (port de requête Steam), 5055/tcp (port additionnel)

⁠Prérequis

Docker + Docker Compose
Quelques Go d'espace disque libre pour SteamCMD et les fichiers du serveur
Si le serveur doit être accessible depuis internet, rediriger les ports ci-dessous sur le routeur (ce serveur de jeu est destiné au réseau « Jeux vidéo » dans une configuration homelab isolée)

⁠Méthode 1 — Installation rapide depuis Docker Hub (recommandée)

mkdir -p ~/solace_crafting && cd ~/solace_crafting

Créer un fichier docker-compose.yml :

services:
  solace-server:
    image: ludix0/solace_crafting:latest
    container_name: solace_crafting
    restart: unless-stopped
    ports:
      - "7777:27015/tcp"
      - "27016:27016/udp"
      - "7775:5055/tcp"
    environment:
      - TZ=Europe/Paris
      - PUID=1000
      - PGID=1000
      - UPDATE_ON_START=true
      - SERVER_NAME=Mon-Serveur-Solace
      - DESCRIPTION=Mon serveur dédié.
      - SERVER_PORT=27015
      - STEAMQUERYPORT=27016
      - PASSWORD=
      - MAX_PLAYERS=10
      - ALLOWADMIN=false
      - ADMINPASSWORD=
      - WORLD_NAME=Gaia
    volumes:
      - ./volumes/filesServer:/home/steam/solace_server
      - ./volumes/steamcmd:/home/steam/steamcmd
      - "./volumes/config_files:/home/steam/.config/unity3d/Big Kitty Games/Solace Crafting"

docker compose up -d
docker compose logs -f

⁠Méthode 2 — Build depuis les sources (GitHub)

git clone https://github.com/Ludix0/solace_crafting.git
cd solace_crafting
ln -sf /chemin/vers/vos/secrets.env .env   # ou créer un .env avec les variables ci-dessous
docker build -t ludix0/solace_crafting:latest .
docker compose up -d

⁠Variables d'environnement

Variable	Requise	Description
`PUID`	Non (défaut `1000`)	UID avec lequel l'utilisateur `steam` s'exécute dans le conteneur
`PGID`	Non (défaut `1000`)	GID avec lequel l'utilisateur `steam` s'exécute dans le conteneur
`SERVER_NAME`	Non (défaut `MonServeurSolace`)	Nom du serveur affiché dans la liste des serveurs
`DESCRIPTION`	Non	Description du serveur, écrite dans `servercfg.dat`
`WORLD_NAME`	Non (défaut `World1`)	Nom de la sauvegarde de monde à utiliser (`worldSaveToUse`)
`SERVER_PORT`	Non (défaut `27015`)	Port de jeu utilisé par le serveur
`STEAMQUERYPORT`	Non	Port de requête Steam ; doit correspondre au port UDP exposé/mappé
`PASSWORD`	Non (défaut vide = serveur public)	Mot de passe de connexion ; s'il est défini, le serveur est marqué privé
`MAX_PLAYERS`	Non (défaut `10`)	Nombre maximum de joueurs simultanés
`ALLOWADMIN`	Non	Active le mot de passe administrateur (`true`/`false`)
`ADMINPASSWORD`	Non	Mot de passe administrateur, utilisé uniquement si `ALLOWADMIN=true`
`UPDATE_ON_START`	Non	Si `true`, SteamCMD met à jour/valide le serveur à chaque démarrage du conteneur ; sinon l'installation ne se fait qu'au premier démarrage (si le binaire du serveur est absent)
`TZ`	Non	Fuseau horaire du conteneur

⁠Volumes

Volume	Contenu
`/home/steam/solace_server`	Binaires et fichiers du serveur de jeu, téléchargés/mis à jour par SteamCMD (App ID `1086950`)
`/home/steam/steamcmd`	Installation de SteamCMD
`/home/steam/.config/unity3d/Big Kitty Games/Solace Crafting`	Dossier de configuration Unity du serveur, incluant le fichier `servercfg.dat` généré et les sauvegardes de monde

⁠Ports

Port	Protocole	Usage
`27015`	TCP	Port de jeu principal (`SERVER_PORT`)
`27016`	UDP	Port de requête Steam (`STEAMQUERYPORT`)
`5055`	TCP	Port additionnel mappé par le conteneur (non documenté davantage dans les fichiers sources)

Tag summary

Recent tags

Content type

Image

Digest

sha256:69c2a06a9…

Size

195 MB

Last updated

7 days ago

docker pull ludix0/solace_crafting