Getting started

This guide walks you through the local dev environment. Akkadia uses a Devcontainer for a consistent toolchain and Docker Compose to run the full stack (chain, services, and client).

Who this is for

Developers who want to run the stack locally
Contributors working on servers (WS/HTTP) or contracts (Gno)
People extending docs and shared types (proto/DTO)

Recommended path

Installation — get Devcontainer + Docker ready
Configuration — services, profiles, and startup flow
Project structure
Running Akkadia

Quick start

Open the repo in VS Code and Reopen in Container.
Start the app stack:


docker compose up -d

Tail logs for a service you care about:


docker compose logs -f server-world