Skip to content

Instantly share code, notes, and snippets.

@LsHallo
Last active January 29, 2026 22:07
Show Gist options
  • Select an option

  • Save LsHallo/96bf6ef035ef4133fabf065034f76368 to your computer and use it in GitHub Desktop.

Select an option

Save LsHallo/96bf6ef035ef4133fabf065034f76368 to your computer and use it in GitHub Desktop.
Eco Server with Docker (Official Strangeloops Image)

Eco Server

Since there is no official documentation on how to use the docker image provided at strangeloopgames/eco-game-server I will go over some details that you have to consider when running the docker container.

First of all I find it easiest to download the server locally and create all configuration files using the UI. It is also necessary to put the files into the Mods directory since I will be exposing it to the host file system.

  1. Go to the strangeloop website and login to your account. If you did not link your steam account you should do that now so you can download the server files.
  2. Put the files into a folder in a convenient location (Will only be used temporarily)
  3. Run the server with the appropriate means (EcoServer.exe or EcoServer.sh)
  4. Configure your server like you want it using the UI
  5. Stop the server
  6. Copy the Configs and Mods folder to the location you want to be using for your server on your host file system (e.g.: /opt/eco-server)
  7. Remove all locally downloaded eco files
  8. Run the docker container using
docker run -d \
--name eco \
-p 3000:3000/udp \
-p 3001:3001/tcp \
-v /opt/eco-server/Configs:/app/Configs \
-v /opt/eco-server/Storage:/app/Storage \
-v /opt/eco-server/Mods:/app/Mods \
strangeloopgames/eco-game-server:latest
services:
  eco:
    image: strangeloopgames/eco-game-server:latest
    container_name: eco
    ports:
      - 3000:3000/udp
      - 3001:3001/tcp
    volumes:
      - /opt/eco-server/Configs:/app/Configs
      - /opt/eco-server/Storage:/app/Storage
      - /opt/eco-server/Mods:/app/Mods
    restart: unless-stopped
  1. Wait for the server to generate the world (might take a few minutes) and connect afterwards.
@AlexWhitehouse
Copy link

@LsHallo and anyone else for future reference:

Inside of the docker-compose.yml you need to add this:

command: ["./EcoServer", "--nogui", "--userToken=YOUR_TOKEN"]

or for user, pass:

command: ["./EcoServer", "--nogui", "--username=YOUR_USERNAME", "--password=YOUR_PASSWORD"]

This will actually run the server and override the normal command so that it will launch with the correct authentication, otherwise the server won't start.

Regardless, thank for you the above guide, helped me a lot!

Just want to say thanks for posting this, I couldn't find this anywhere else on the internet

@smushis
Copy link

smushis commented Jan 29, 2026

@LsHallo and anyone else for future reference:

Inside of the docker-compose.yml you need to add this:

command: ["./EcoServer", "--nogui", "--userToken=YOUR_TOKEN"]

or for user, pass:

command: ["./EcoServer", "--nogui", "--username=YOUR_USERNAME", "--password=YOUR_PASSWORD"]

This will actually run the server and override the normal command so that it will launch with the correct authentication, otherwise the server won't start.

Regardless, thank for you the above guide, helped me a lot!

Thank you my friend!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment