Run Akkadia

This guide assumes you are using the Devcontainer plus Docker Compose workflow. The Devcontainer provides the toolchain; Docker Compose runs the services.

Start the stack

From the repo root:


docker compose up -d

This brings up:

mariadb, redis
init-workspace (one-time pnpm install)
gnoland + gnoweb
init-txs (migrate + seed + gno init)
app services (server-*, client-game)

Open a dev shell

If you need an interactive shell with the repo mounted:


docker compose --profile dev up -d

Then attach to the devcontainer:


docker compose exec devcontainer bash

Run docs locally

Docs are not part of the Compose stack. Run them in the devcontainer:


cd client/docs
pnpm dev

Service logs


docker compose logs -f gnoland
docker compose logs -f server-world
docker compose logs -f client-game

Start a single service

Ignore dependencies and run only one service:


docker compose up -d --no-deps gnoland

Stop / reset


docker compose down

If you need to reset DB/Redis data:


./bin/docker/reset.sh

Common checks

Verify required ports are free (26657, 3003, 3030, 3020, 3010, 36036)
Ensure each service repo has its own .env.development
If a service won’t start, check its logs first