Getting started

Prerequisites

A working Docker installation. You can use Docker Desktop

Setup

Download the compose file, envfile and configuration file to your computer. You can put this in your Screeps project. Copy .env.sample to .env, this can hold secrets for you, and should be ignored in git!

You can use this command (in a shell) to do the above, in your current directory.

curl --remote-name-all https://raw.githubusercontent.com/Jomik/screeps-server/main/{docker-compose.yml,.env.sample,config.yml} && cp .env.sample .env && echo ".env" >> .gitignore

Paste your Steam API key into .env.

Configuration

Edit config.yml to add mods and bots. Some mods also look there for configuration. We currently add the following mods, as default:

• [screepsmod-auth]
• [screepsmod-admin-utils]
• [screepsmod-mongo]

Starting the server

In your project run docker compose up -d. Run docker compose logs screeps -f to view and follow the logs for the screeps-server container. To stop following the logs, press CTRL + C. Assuming nothing went wrong, you should be able to connect to your server on http://localhost:21025.