Skip to content

Run the worker using docker

lemteay edited this page Jan 21, 2026 · 2 revisions

Docker can be used to convienently run the fishtest worker without having to worry about the local environment and dependencies.
The worker uses an archlinux:latest base image and runs pacman updates in the background to
keep the software stack up to date.
This is useful to get the latest compilers and tools for running the worker.

  1. Clone the repository
git clone https://github.com/official-stockfish/docker-fishtest
  1. Enter the worker directory
cd worker
  1. Create the .env file based on the example one.
cp .env.example .env
  1. Update the .env file with your credentials

  2. Start the worker using docker compose:

docker compose up -d

Notes:

  • The container will auto start in the background after a reboot
  • New updates to the compose might be made which can be applied by pulling git pull the latest changes and running docker compose up -d --build
  • If your want to use your own Docker container, include the --shm-size 1g flag. This allows Stockfish to utilize shared memory, which can significantly improves worker performance.

Clone this wiki locally