Skip to main content
This page is for running Nasiko yourself. Problems with coding agents, reporting, or routing are covered in Troubleshooting coding agents. Problems specific to nasiko up are in Install and connect.

Starting the server

docker: command not found. Install Docker and make sure the engine is running. docker-compose fails, or depends_on conditions are rejected. You’re using the legacy v1 binary. Use docker compose (with a space), from the Compose V2 plugin. permission denied ... Docker daemon socket.
  • macOS and Windows: start Docker Desktop and wait until the engine is running.
  • Linux and WSL: add yourself to the docker group, then log out and back in:
failed to connect to Postgres, or the server can’t reach Postgres. The backing services aren’t ready yet. Run docker compose up -d and wait until docker compose ps shows them as healthy. invalid SECRETS_ENCRYPTION_KEY or Invalid padding. The key must be base64 of exactly 32 bytes. Generate a new one:
Only do this on a fresh install. Secrets already stored can’t be decrypted with a new key. SEED_TOOLKITS is set but COMPOSIO_API_KEY is not. SEED_TOOLKITS is optional. Set COMPOSIO_API_KEY as well, or leave both unset if you don’t need Composio. See Server configuration. address already in use on ports 9000, 4317, or 4318. Another process holds the port. Find it with lsof -i :9000. On Windows this is usually two Docker engines running at once, Docker Desktop and a native engine inside WSL. Keep one, run wsl --shutdown, reopen your terminal, and run docker compose up -d again. See Services and ports. The dashboard won’t load. Check that docker compose ps shows server as Up, then open http://localhost:8080. Follow its logs with docker compose logs -f server. Changes to .env have no effect. Run docker compose up -d. docker compose restart doesn’t reload the environment.

Deployed agents

An agent logs [Errno -2] Name or service not known (Linux). Docker Engine on Linux doesn’t provide host.docker.internal. Recreate the agent with --add-host host.docker.internal:host-gateway, or set MCP_GATEWAY_PUBLIC_URL to the Docker bridge IP. See Deploy the stack. Uploading an agent fails with 500 and agents_owner_id_fkey. Your sign-in is from a database that has since been reset. Sign out and back in. If that doesn’t help, reset the local stack and sign in fresh. This deletes all local data:

Building from source

The install script avoids all of these. They apply when you build the CLI or server with cargo.

Windows and WSL

: command not found when sourcing .env. Windows line endings break source in bash. Convert the file:
ext4.vhdx: path not found from WSL. The WSL distribution is corrupted. Reinstall it, which deletes its files: