Docker

For a small edge server, start with one Akan app container.

Minimal Compose

This is a simplified example for one app. Replace `myapp` and the image name with your app.

docker-compose.yaml

`akan build` embeds `console.js` next to `main.js`, so you can open an operator console without creating files inside the container.

Set `AKAN_CONSOLE=1` only on the exec command for production-like environments.

Docker exec

`AKAN_PUBLIC_OPERATION_MODE=edge`: tells the app it is running as an edge deployment.
`AKAN_SQLITE_DIR`: keeps sqlite files in a mounted folder.
`AKAN_LOG_DIR`: keeps runtime logs outside the container filesystem.
`AKAN_REPLICA`: controls child process roles for scaling.

`AKAN_REPLICA` is a compact way to choose how many federation, batch, and all-purpose child processes the app starts.

Replica examples

Keep the first compose file boring. Add extra services only when the app really needs them.
Back up the sqlite volume before replacing edge hardware.
Check logs from the mounted folder when the container restarts repeatedly.