{"id":27772298,"url":"https://github.com/bonsaibauer/enshrouded_server_docker","last_synced_at":"2026-02-04T22:04:25.876Z","repository":{"id":290369003,"uuid":"974203549","full_name":"bonsaibauer/enshrouded_server_docker","owner":"bonsaibauer","description":"Setting up an Enshrouded Dedicated Server in a container","archived":false,"fork":false,"pushed_at":"2025-04-28T12:27:44.000Z","size":3,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-29T23:58:21.521Z","etag":null,"topics":["beginner","beginner-friendly","dedicated","dedicated-server","docker","enshrouded","enshrouded-server","games","gameserver","gaming","guide","server","server-setup","steamcmd","steamcmd-servers"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bonsaibauer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-28T12:14:31.000Z","updated_at":"2025-04-28T12:50:30.000Z","dependencies_parsed_at":"2025-04-28T13:47:24.164Z","dependency_job_id":"9f84c33b-0ed1-4361-9d5b-5ddbff78aa3d","html_url":"https://github.com/bonsaibauer/enshrouded_server_docker","commit_stats":null,"previous_names":["bonsaibauer/enshrouded_server_docker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonsaibauer%2Fenshrouded_server_docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonsaibauer%2Fenshrouded_server_docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonsaibauer%2Fenshrouded_server_docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonsaibauer%2Fenshrouded_server_docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bonsaibauer","download_url":"https://codeload.github.com/bonsaibauer/enshrouded_server_docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251602817,"owners_count":21615963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["beginner","beginner-friendly","dedicated","dedicated-server","docker","enshrouded","enshrouded-server","games","gameserver","gaming","guide","server","server-setup","steamcmd","steamcmd-servers"],"created_at":"2025-04-29T23:58:25.389Z","updated_at":"2026-02-04T22:04:25.871Z","avatar_url":"https://github.com/bonsaibauer.png","language":null,"funding_links":["https://buymeacoffee.com/bonsaibauer"],"categories":[],"sub_categories":[],"readme":"[![Repository](https://img.shields.io/badge/Repository-enshrouded__server__docker-blue?style=flat\u0026logo=github)](https://github.com/bonsaibauer/enshrouded_server_docker)\n![License](https://img.shields.io/badge/License-MIT-blue)\n[![Docker Pulls](https://img.shields.io/docker/pulls/bonsaibauer/enshrouded_server_docker.svg?cacheSeconds=60)](https://hub.docker.com/r/bonsaibauer/enshrouded_server_docker)\n[![Docker Stars](https://img.shields.io/docker/stars/bonsaibauer/enshrouded_server_docker.svg?cacheSeconds=60)](https://hub.docker.com/r/bonsaibauer/enshrouded_server_docker)\n[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/bonsaibauer/enshrouded_server_docker/latest)](https://hub.docker.com/r/bonsaibauer/enshrouded_server_docker)\n![Visitors](https://visitor-badge.laobi.icu/badge?page_id=bonsaibauer.enshrouded_server_docker)\n\n[![Report Problem](https://img.shields.io/badge/Report-new_Problem_or_Issue-critical?style=flat\u0026logo=github)](https://github.com/bonsaibauer/enshrouded_server_docker/issues/new)\n\n![GitHub Stars](https://img.shields.io/github/stars/bonsaibauer/enshrouded_server_docker?style=social)\n![GitHub Forks](https://img.shields.io/github/forks/bonsaibauer/enshrouded_server_docker?style=social)\n\n\u003ca href=\"https://github.com/bonsaibauer/enshrouded_server_ubuntu\" target=\"_blank\" style=\"display:inline-block; padding:20px 30px; background-color:#28a745; color:#ffffff; text-decoration:none; border-radius:10px; font-size:18px; font-weight:600; box-shadow:0 8px 20px rgba(0,0,0,0.2);\"\u003e\n  🐧 Use Ubuntu? Go to bonsaibauer/enshrouded_server_ubuntu →\n\u003c/a\u003e\n\n# Setting Up an Enshrouded Dedicated Server with Docker: A Beginner's Guide\n\nEmbark 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.\n\n## Enshrouded: A Vast World of Survival and Magic\n\n**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.\n\n![Enshrouded Docker Server Setup](images/enshrouded_docker_v2.png)  \n\u003csub\u003eImage generated with the help of [ChatGPT](https://openai.com/chatgpt)\u003c/sub\u003e\n\nRoad to Release — Enshrouded is slated for an Autumn 2026 launch; the roadmap below shows the milestones to release.\n\n![Road to Release 2026](images/road_to_release_2026.png)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePatch #10 v0.9.0.1 – Wake of the Water (2025-11)\u003c/strong\u003e\u003c/summary\u003e\n\n![Wake of the Water Update](images/update_wake_of_water.jpeg)\n\n- Dynamically simulated water, water tools, and flooding safeguards bring bases to life.\n- Veilwater Basin biome, new quests, enemies, and gear raise the progression cap to level 45.\n- Fishing, greatswords, rebalanced loot, and workstation force requirements deepen crafting/combat.\n- Dedicated servers now expose tags, a visitor role with terraforming limits, and improved admin tools.\n\n\u003c/details\u003e\n\n### Full Settings + Example Config\n\n- All server/gameplay fields are documented in [`docs/enshrouded_server.md`](docs/enshrouded_server.md).\n- A complete sample with every setting populated ships in [`ressources/enshrouded_server.json`](ressources/enshrouded_server.json).\n\n---\n\n## 0. Preparing Your Environment (Prerequisites)\n\nYou can run the Enshrouded server inside a Docker container on **any operating system that supports Docker**.  \nOpen the section below for the supported OS matrix and prerequisites.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOS matrix \u0026 prerequisites (click to expand)\u003c/strong\u003e\u003c/summary\u003e\n\n| Production-Ready Linux               | Desktop/Test Only                  | Notes                                                  |\n|-------------------------------------|------------------------------------|--------------------------------------------------------|\n| ✅ Ubuntu 24.04 LTS (recommended)   | ✅ macOS (Docker Desktop)          | ⚠️ Not suitable for hosting a live server              |\n| ✅ Ubuntu 22.04 LTS                 | ✅ Windows 10/11 (WSL 2 + Docker Desktop) | ⚠️ Use for testing or development only       |\n| ✅ Ubuntu 20.04 LTS                 |                                    |                                                        |\n| ✅ Debian 12 / 11                   |                                    |                                                        |\n| ✅ Fedora 38+                       |                                    |                                                        |\n| ✅ Arch Linux                       |                                    | Rolling release — always up-to-date                    |\n| ✅ AlmaLinux / Rocky Linux 9 / 8    |                                    | CentOS alternatives                                    |\n| ✅ openSUSE Leap / Tumbleweed       |                                    |                                                        |\n\nYou’ll need:\n\n- A system with Docker and Docker Compose installed\n- sudo or administrative privileges\n- `ufw` or firewall configuration (ensure port **15637** is open and forwarded)\n\n\u003e [!TIP]\n\u003e Open UDP **15637** on both your host firewall *and* your router’s port forward. This is the #1 reason friends cannot see your server.\n\n\u003c/details\u003e\n\n# 1. Installing Docker (Ubuntu 24.04 and Other Linux Systems)\n\nDocker 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.\n\nThis guide will walk you through installing Docker on Ubuntu 24.04. These steps also work on most other Linux distributions with minor adjustments.\n\n### Step 1: Update Your Package Index\n\nBefore installing anything, update your system to ensure all packages are current.\n\n`Debian/Ubuntu`\n```\nsudo apt update \u0026\u0026 sudo apt upgrade -y\n```\n- `sudo apt update`: Refreshes the package index.\n- `sudo apt upgrade -y`: Upgrades installed packages automatically.\n\n\u003e `Fedora`\n\u003e ```\n\u003e sudo dnf upgrade --refresh\n\u003e ```\n\u003e \n\u003e `Arch Linux`\n\u003e ```\n\u003e sudo pacman -Syu\n\u003e ```\n\n### Step 2: Install Required Dependencies\n\nDocker relies on a few helper packages. Install them with:\n\n```bash\nsudo apt install apt-transport-https ca-certificates curl software-properties-common lsb-release gnupg -y\n```\n\n- `apt-transport-https`: Allows `apt` to use HTTPS.\n- `ca-certificates`: Ensures your system trusts SSL certificates.\n- `curl`: Command-line tool for downloading files.\n- `software-properties-common`: Adds support for `add-apt-repository`.\n- `lsb-release`: Provides OS version info.\n- `gnupg`: Required for managing GPG keys.\n\n### Step 3: Add Docker’s Official GPG Key\n\nDocker signs its packages for security. Add their GPG key:\n\n```bash\ncurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg\n```\n\n### Step 4: Add Docker’s APT Repository\n\nConfigure your system to use Docker’s stable software repository:\n\n```bash\necho   \"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 \u003e /dev/null\n```\n\n### Step 5: Install Docker Engine\n\nUpdate your package index again and install Docker:\n\n```bash\nsudo apt update\nsudo apt install docker-ce docker-ce-cli containerd.io -y\n```\n\n- `docker-ce`: Docker Community Edition\n- `docker-ce-cli`: Docker command-line interface\n- `containerd.io`: Container runtime used by Docker\n\nVerify Docker is running:\n\n```bash\nsudo systemctl status docker\n```\n\nPress `q` to exit the status screen.\n\n# 2. Create user and working directory\n\nTo allow the Docker container to persist game data and configurations, we create a dedicated system user and set up the correct directory.\n\nRun these commands as root or with `sudo`:\n\n```bash\n# Create a system user 'enshrouded' without login shell\nsudo useradd -m -r -s /bin/false enshrouded\n\n# Ensure the home directory exists\nsudo mkdir -p /home/enshrouded/server_1\n\n# Set proper ownership \nsudo sudo chown enshrouded:enshrouded /home/enshrouded/server_1\n```\n\n\u003e 🛡️ This ensures that the container can write to `/home/enshrouded/server_1` and all server data stays in one clean location.\n\n# 3. Quickstart\nGo to ...\n```bash\ncd /home/enshrouded/server_1\n```\n\nRun the container with:\n\n```bash\n  docker run \\\n    --name enshroudedserver \\\n    --restart=unless-stopped \\\n    -e ENSHROUDED_PORT=15637 \\\n    -p 15637:15637/udp \\\n    -e ENSHROUDED_USER_ID=\"$(id -u enshrouded)\" \\\n    -e ENSHROUDED_GROUP_ID=\"$(id -g enshrouded)\" \\\n    -v /home/enshrouded/server_1:/home/steam/enshrouded \\\n    bonsaibauer/enshrouded_server_docker:latest\n  ```\n\n---\n\nWait until you see the following logs to confirm it's running:\n```bash\n[Session] 'HostOnline' (up)!\n[Session] finished transition from 'Lobby' to 'Host_Online' (current='Host_Online')!\n```\n\nTo exit the log view safely and keep the server running, press:\n```bash\nCtrl + C\n```\n\n---\n\n# 4. Edit server configuration\n\u003e 🔧 This file is located in the mounted directory:\n\u003e `/home/enshrouded/server_1/enshrouded_server.json`\n\n```bash\nnano enshrouded_server.json\n```\n\nEdit the `enshrouded_server.json` file to configure your server settings.\n\n---\n\n### General Server Settings\n\n| Setting            | Description                                | Example / Default Value | Options / Notes          |\n|--------------------|--------------------------------------------|--------------------------|---------------------------|\n| **name**           | Name of the server                         | \"Enshrouded Server\"      | Any string                |\n| **saveDirectory**  | Directory where savegames are stored       | \"./savegame\"             | File path                 |\n| **logDirectory**   | Directory for log files                    | \"./logs\"                 | File path                 |\n| **ip**             | Server IP binding                          | \"0.0.0.0\"                | Server ip adress          |\n| ...                | ...                                        | ...                      | ...                       |\n\n... [View full server settings here](https://github.com/bonsaibauer/enshrouded_server_docker/blob/main/docs/enshrouded_server.md)\n\n\u003e **ℹ️ Note: Nano editor**\n\u003e\n\u003e After editing the `enshrouded_server.json` file, follow these steps to save your changes and exit the Nano editor:\n\u003e\n\u003e 1. **Save**:\n\u003e    - Press `CTRL + O` (this means \"Write Out\").\n\u003e    - Press `Enter` to confirm and save the file with the current name.\n\u003e\n\u003e 2. **Exit**:\n\u003e    - Press `CTRL + X` to close the Nano editor.\n\u003e\n\u003e You will then return to the regular command line.\n\n# 5. Docker commands to manage Enshrouded Server\n## Start the Enshrouded Server\n\nIf the container has already been created (e.g. from a previous `docker run`), you can start it again with:\n\n```bash\ndocker start enshroudedserver\n```\n\n## Stop the Enshrouded Server\n\nTo safely stop the server without deleting the container:\n\n```bash\ndocker stop enshroudedserver\n```\n\n## Update the Enshrouded Server\n\nTo restart the container (stop and start again):\n\n```bash\ndocker restart enshroudedserver\n```\n\n## Stop and remove the container\n   ```bash\n   docker stop enshroudedserver\n   docker rm enshroudedserver\n   ```\n\n## View live logs\n\nFollow the server logs in real time (use `Ctrl+C` to leave log view; the container keeps running):\n\n```bash\ndocker logs -f enshroudedserver\n```\n\n## Buy Me A Coffee\nIf 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!\n\n\u003ca href=\"https://buymeacoffee.com/bonsaibauer\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"41\" width=\"174\"\u003e\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonsaibauer%2Fenshrouded_server_docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbonsaibauer%2Fenshrouded_server_docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonsaibauer%2Fenshrouded_server_docker/lists"}