This repository provides the required Docker Compose files and configuration files to run a complete Blocksembler deployment. It includes all necessary services, including the frontend, API backend, database, message queue, and supporting components, enabling a reproducible setup of the Blocksembler environment.
To run Blocksembler, make sure that both docker and docker compose are installed on your machine.
We recommend following the official installation instructions:
https://docs.docker.com/get-started/get-docker/
docker compose -f compose.yml -f compose.leonding.yml up -d
To initialize the database to the state used during the competition, first open an interactive shell in the database container:
docker exec -it blocksembler-db /bin/bash
The script that imports all competition data is already mounted into the database container (db_scripts/create.sql). Run the script using the following command:
psql -U postgres -d blocksembler -f ./db_scripts/create.sql
To start exploring Blocksembler, open your favorite browser and visit http://localhost.
Remark: This version of the blocksembler-deployment repository represents the version that was used for the Blocksembler Coding Competition held on 10 February 2026 at HTL Leonding, Austria. However, the configuration file (leonding.env) initially pointed to the wrong backend. This issue was fixed on-site, and the correction was later added to the repository when preparing the replication package for publication alongside the paper reporting the results of this coding competition.