KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

docker-the-forest-dedicated-server

★ 136 Open GitHub ↗

Docker container to easily provision and manage The Forest Dedicated Server with Wine

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Docker - TheForest Dedicated Server

[![Build-Status master](https://github.com/jammsen/docker-the-forest-dedicated-server/blob/master/.github/workflows/docker-build-and-push-prod.yml/badge.svg)](https://github.com/jammsen/docker-the-forest-dedicated-server/blob/master/.github/workflows/docker-build-and-push-prod.yml)
![Docker Pulls](https://img.shields.io/docker/pulls/jammsen/the-forest-dedicated-server)
![Docker Stars](https://img.shields.io/docker/stars/jammsen/the-forest-dedicated-server)
![Image Size](https://img.shields.io/docker/image-size/jammsen/the-forest-dedicated-server/latest)
[![Discord](https://img.shields.io/discord/532141442731212810?logo=discord&label=Discord&link=https%3A%2F%2Fdiscord.gg%2F7tacb9Q6tj)](https://discord.gg/7tacb9Q6tj)

> [!TIP]
> Do you want to chat with the community?
>
> **[Join us on Discord](https://discord.gg/7tacb9Q6tj)**

> [!WARNING]  
> Update Jan-2025: This Docker-Image had a major refactoring including breaking changes in downwards-compability. This was done for removing dependency of "root" in the image, which caused various SteamCMD, NAS, QNAP, Synology and Portainer problems. Also the Docker-Base-Image was switched and there was better process-handling added to make sure the process exits cleanly, no matter how Docker or the User stops the server.
>
> It is recommended to do a fresh install, via the new readme in a fresh directory to understand what changed and work backwards to adapt the changes, or migrate the savegame from the old server to the new one, up to you. If you need help, feel free to join the Discord server and ask in the right channel for the game.

> [!NOTE]  
> If you are looking for the Sons of the Forest version, please look here: https://github.com/jammsen/docker-sons-of-the-forest-dedicated-server

This repository includes a TheForest Dedicated Server based on Docker with Wine and an example config.

___

## Table of Contents

- [Docker - TheForest Dedicated Server](#docker---theforest-dedicated-server)
  - [Table of Contents](#table-of-contents)
  - [How to ask for support for this Docker image](#how-to-ask-for-support-for-this-docker-image)
  - [Requirements](#requirements)
  - [Minimum system requirements](#minimum-system-requirements)
  - [Changelog](#changelog)
  - [Getting started](#getting-started)
    - [Docker-Compose - Example](#docker-compose---example)
  - [Planned features in the future](#planned-features-in-the-future)
  - [Software used](#software-used)

## How to ask for support for this Docker image

If you need support for this Docker image:

- Feel free to create a new issue.
  - You can reference other issues if you're experiencing a similar problem via #issue-number.
- Follow the instructions and answer the questions of people who are willing to help you.
- Once your issue is resolved, please close it and please consider giving this repo and the [Docker-Hub repository](https://hub.docker.com/repository/docker/jammsen/the-forest-dedicated-server) a star.
- Please note that any issue that has been inactive for a week will be closed due to inactivity.

Please avoid:

- Reusing or necroing issues. This can lead to spam and may harass participants who didn't agree to be part of your new problem.
- If this happens, we reserve the right to lock the issue or delete the comments, you have been warned!

## Requirements

To run this Docker image, you need a basic understanding of Docker, Docker-Compose, Linux, and Networking (Port-Forwarding/NAT).

## Minimum system requirements

| Resource | Minimum (2-4 Players)   | Recommended (4 Players) |
| -------- | ----------------------- | ----------------------- |
| CPU      | 2-4 CPU-Cores @ Mid GHz | 4+ CPU Cores @ High GHz |
| RAM      | 4GB+ RAM                | 8GB+ RAM                |
| Storage  | 10GB+                   | 20GB+ (SSD prefered)    |

## Changelog

You can find the [changelog here](CHANGELOG.md)

## Getting started

WARNING: If you dont do Step 1 and 2 your server can/will not save!
1. Create a new game server account over at https://steamcommunity.com/dev/managegameservers (Use AppID: `242760`)
2. Insert the Login Token into the environment variable via docker-run or docker-compose (at `SERVER_STEAM_ACCOUNT_TOKEN`)
3. Go to the directory you want to host your gameserver on your Dockernode
4. Create a sub-directory called `game`
5. Download the [compose.yml](compose.yml) and the default.env or use the following example
6. Review the 2 files and setup the settings you like - WARNING: If you dont change the passwords, your server will crash-loop! Its by design, to ensure better security!
7. Setup Port-Forwarding or NAT for the ports in the Docker-Compose file
8. Start the container via Docker Compose
9. (Tip: Extended config settings, which are not covered by Docker Compose, can be setup in the config-file of the server - You can find it at `game/config/config.cfg`)

### Docker-Compose - Example

```yaml
services:
  the-forest-dedicated-server:
    container_name: the-forest-dedicated-server
    image: jammsen/the-forest-dedicated-server:latest
    restart: always
    env_file:
      - ./default.env
    ports:
      - 8766:8766/udp
      - 27015:27015/udp
      - 27016:27016/udp
    volumes:
      - ./game:/theforest
```

> **Note:** The `FILTER_SHADER_AND_MESH_AND_WINE_DEBUG` environment variable (default: true) controls whether Wine debug-logs and known-harmless warning messages (shader warnings, headless input `NullReferenceException` spam) are filtered from the container logs, keeping them cleaner. Set it to false if you want to see all messages.

## Planned features in the future

- Feel free to suggest features in the issues

## Software used

- Debian Trixie and SteamCMD via cm2network/steamcmd:root image as base-image
- gosu
- procps
- winbind
- wine
- xvfb
* TheForest Dedicated Server (APP-ID: 556450)

docker-the-forest-dedicated-server

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README