Skip to content

Run the worker using Docker

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
sh
git clone https://github.com/official-stockfish/docker-fishtest
  1. Enter the worker directory
sh
cd worker
  1. Create the .env file based on the example one.
sh
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
  • When using the image from our container registry, the following two commands can be run to update the worker image.
    Generally it shouldn't be required to update the git repo itself after the first clone.
docker compose pull
docker compose up -d