https://github.com/bonsaibauer/enshrouded_server_docker
Setting up an Enshrouded Dedicated Server in a container
https://github.com/bonsaibauer/enshrouded_server_docker
beginner beginner-friendly dedicated dedicated-server docker enshrouded enshrouded-server games gameserver gaming guide server server-setup steamcmd steamcmd-servers
Last synced: 8 days ago
JSON representation
Setting up an Enshrouded Dedicated Server in a container
- Host: GitHub
- URL: https://github.com/bonsaibauer/enshrouded_server_docker
- Owner: bonsaibauer
- License: mit
- Created: 2025-04-28T12:14:31.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-04-28T12:27:44.000Z (10 months ago)
- Last Synced: 2025-04-29T23:58:21.521Z (10 months ago)
- Topics: beginner, beginner-friendly, dedicated, dedicated-server, docker, enshrouded, enshrouded-server, games, gameserver, gaming, guide, server, server-setup, steamcmd, steamcmd-servers
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/bonsaibauer/enshrouded_server_docker)
[](https://hub.docker.com/r/bonsaibauer/enshrouded_server_docker)
[](https://hub.docker.com/r/bonsaibauer/enshrouded_server_docker)
[](https://hub.docker.com/r/bonsaibauer/enshrouded_server_docker)
[](https://github.com/bonsaibauer/enshrouded_server_docker/issues/new)
🐧 Use Ubuntu? Go to bonsaibauer/enshrouded_server_ubuntu →
# Setting Up an Enshrouded Dedicated Server with Docker: A Beginner's Guide
Embark on an adventure in the mystical world of Embervale with your own dedicated **Enshrouded** server. This guide walks you through setting up a dedicated server using **Docker**, making the process consistent and easy across different operating systems.
## Enshrouded: A Vast World of Survival and Magic
**Enshrouded** is an immersive survival action RPG set in a vast, voxel-based open world. Players must explore dangerous lands, craft for survival, and battle mystical creatures. The game supports cooperative multiplayer for up to 16 players, creating the perfect environment for shared adventures.
Image generated with the help of [ChatGPT](https://openai.com/chatgpt)
Road to Release — Enshrouded is slated for an Autumn 2026 launch; the roadmap below shows the milestones to release.
Patch #10 v0.9.0.1 – Wake of the Water (2025-11)
- Dynamically simulated water, water tools, and flooding safeguards bring bases to life.
- Veilwater Basin biome, new quests, enemies, and gear raise the progression cap to level 45.
- Fishing, greatswords, rebalanced loot, and workstation force requirements deepen crafting/combat.
- Dedicated servers now expose tags, a visitor role with terraforming limits, and improved admin tools.
### Full Settings + Example Config
- All server/gameplay fields are documented in [`docs/enshrouded_server.md`](docs/enshrouded_server.md).
- A complete sample with every setting populated ships in [`ressources/enshrouded_server.json`](ressources/enshrouded_server.json).
---
## 0. Preparing Your Environment (Prerequisites)
You can run the Enshrouded server inside a Docker container on **any operating system that supports Docker**.
Open the section below for the supported OS matrix and prerequisites.
OS matrix & prerequisites (click to expand)
| Production-Ready Linux | Desktop/Test Only | Notes |
|-------------------------------------|------------------------------------|--------------------------------------------------------|
| ✅ Ubuntu 24.04 LTS (recommended) | ✅ macOS (Docker Desktop) | ⚠️ Not suitable for hosting a live server |
| ✅ Ubuntu 22.04 LTS | ✅ Windows 10/11 (WSL 2 + Docker Desktop) | ⚠️ Use for testing or development only |
| ✅ Ubuntu 20.04 LTS | | |
| ✅ Debian 12 / 11 | | |
| ✅ Fedora 38+ | | |
| ✅ Arch Linux | | Rolling release — always up-to-date |
| ✅ AlmaLinux / Rocky Linux 9 / 8 | | CentOS alternatives |
| ✅ openSUSE Leap / Tumbleweed | | |
You’ll need:
- A system with Docker and Docker Compose installed
- sudo or administrative privileges
- `ufw` or firewall configuration (ensure port **15637** is open and forwarded)
> [!TIP]
> Open UDP **15637** on both your host firewall *and* your router’s port forward. This is the #1 reason friends cannot see your server.
# 1. Installing Docker (Ubuntu 24.04 and Other Linux Systems)
Docker allows you to run applications in isolated containers. It's ideal for deploying an Enshrouded dedicated server because it ensures consistency, portability, and easy management.
This guide will walk you through installing Docker on Ubuntu 24.04. These steps also work on most other Linux distributions with minor adjustments.
### Step 1: Update Your Package Index
Before installing anything, update your system to ensure all packages are current.
`Debian/Ubuntu`
```
sudo apt update && sudo apt upgrade -y
```
- `sudo apt update`: Refreshes the package index.
- `sudo apt upgrade -y`: Upgrades installed packages automatically.
> `Fedora`
> ```
> sudo dnf upgrade --refresh
> ```
>
> `Arch Linux`
> ```
> sudo pacman -Syu
> ```
### Step 2: Install Required Dependencies
Docker relies on a few helper packages. Install them with:
```bash
sudo apt install apt-transport-https ca-certificates curl software-properties-common lsb-release gnupg -y
```
- `apt-transport-https`: Allows `apt` to use HTTPS.
- `ca-certificates`: Ensures your system trusts SSL certificates.
- `curl`: Command-line tool for downloading files.
- `software-properties-common`: Adds support for `add-apt-repository`.
- `lsb-release`: Provides OS version info.
- `gnupg`: Required for managing GPG keys.
### Step 3: Add Docker’s Official GPG Key
Docker signs its packages for security. Add their GPG key:
```bash
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
```
### Step 4: Add Docker’s APT Repository
Configure your system to use Docker’s stable software repository:
```bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
### Step 5: Install Docker Engine
Update your package index again and install Docker:
```bash
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io -y
```
- `docker-ce`: Docker Community Edition
- `docker-ce-cli`: Docker command-line interface
- `containerd.io`: Container runtime used by Docker
Verify Docker is running:
```bash
sudo systemctl status docker
```
Press `q` to exit the status screen.
# 2. Create user and working directory
To allow the Docker container to persist game data and configurations, we create a dedicated system user and set up the correct directory.
Run these commands as root or with `sudo`:
```bash
# Create a system user 'enshrouded' without login shell
sudo useradd -m -r -s /bin/false enshrouded
# Ensure the home directory exists
sudo mkdir -p /home/enshrouded/server_1
# Set proper ownership
sudo sudo chown enshrouded:enshrouded /home/enshrouded/server_1
```
> 🛡️ This ensures that the container can write to `/home/enshrouded/server_1` and all server data stays in one clean location.
# 3. Quickstart
Go to ...
```bash
cd /home/enshrouded/server_1
```
Run the container with:
```bash
docker run \
--name enshroudedserver \
--restart=unless-stopped \
-e ENSHROUDED_PORT=15637 \
-p 15637:15637/udp \
-e ENSHROUDED_USER_ID="$(id -u enshrouded)" \
-e ENSHROUDED_GROUP_ID="$(id -g enshrouded)" \
-v /home/enshrouded/server_1:/home/steam/enshrouded \
bonsaibauer/enshrouded_server_docker:latest
```
---
Wait until you see the following logs to confirm it's running:
```bash
[Session] 'HostOnline' (up)!
[Session] finished transition from 'Lobby' to 'Host_Online' (current='Host_Online')!
```
To exit the log view safely and keep the server running, press:
```bash
Ctrl + C
```
---
# 4. Edit server configuration
> 🔧 This file is located in the mounted directory:
> `/home/enshrouded/server_1/enshrouded_server.json`
```bash
nano enshrouded_server.json
```
Edit the `enshrouded_server.json` file to configure your server settings.
---
### General Server Settings
| Setting | Description | Example / Default Value | Options / Notes |
|--------------------|--------------------------------------------|--------------------------|---------------------------|
| **name** | Name of the server | "Enshrouded Server" | Any string |
| **saveDirectory** | Directory where savegames are stored | "./savegame" | File path |
| **logDirectory** | Directory for log files | "./logs" | File path |
| **ip** | Server IP binding | "0.0.0.0" | Server ip adress |
| ... | ... | ... | ... |
... [View full server settings here](https://github.com/bonsaibauer/enshrouded_server_docker/blob/main/docs/enshrouded_server.md)
> **ℹ️ Note: Nano editor**
>
> After editing the `enshrouded_server.json` file, follow these steps to save your changes and exit the Nano editor:
>
> 1. **Save**:
> - Press `CTRL + O` (this means "Write Out").
> - Press `Enter` to confirm and save the file with the current name.
>
> 2. **Exit**:
> - Press `CTRL + X` to close the Nano editor.
>
> You will then return to the regular command line.
# 5. Docker commands to manage Enshrouded Server
## Start the Enshrouded Server
If the container has already been created (e.g. from a previous `docker run`), you can start it again with:
```bash
docker start enshroudedserver
```
## Stop the Enshrouded Server
To safely stop the server without deleting the container:
```bash
docker stop enshroudedserver
```
## Update the Enshrouded Server
To restart the container (stop and start again):
```bash
docker restart enshroudedserver
```
## Stop and remove the container
```bash
docker stop enshroudedserver
docker rm enshroudedserver
```
## View live logs
Follow the server logs in real time (use `Ctrl+C` to leave log view; the container keeps running):
```bash
docker logs -f enshroudedserver
```
## Buy Me A Coffee
If this project has helped you in any way, do buy me a coffee so I can continue to build more of such projects in the future and share them with the community!
