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

2. Enter the worker directory

cd worker

3. Create the .env file based on the example one.

cp .env.example .env

4. Update the .env file with your credentials

5. 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 to 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

• If your want to use your own container, include the --shm-size 1g flag. This allows Stockfish to utilize shared memory, which can significantly improves worker performance.