Manually Starting Koios

Use manual Docker commands for development, testing, or one-off runs. For production deployments, see Running Koios as a Service.

Start the Container

Run Koios with host networking and all volume mounts. Docker automatically creates any named volumes that don't already exist.

docker run -d --name koios --network host \
  --mount source=koios_data_postgres,target=/var/lib/postgresql/16/main \
  --mount source=koios_data_influxdb,target=/root/.influxdbv2 \
  --mount source=koios_media,target=/var/www/koios/media \
  --mount source=koios_logs,target=/var/www/koios/logs \
  --mount source=koios_certs,target=/var/www/koios/certs \
  --mount source=koios_license,target=/var/www/koios/license \
  --mount source=koios_secrets,target=/var/www/koios/secrets \
  aiopinc/koios:latest

Alternative: Explicit Port Mapping

If you prefer not to use host networking, replace --network host with explicit port mappings (-p 443:443 -p 80:80).

First Access

Open a browser and navigate to:

https://<server-ip>

Your browser may show a certificate warning for the self-signed SSL certificate — this is expected. Accept the warning to proceed.

Log in with the default credentials:

• Username: admin
• Password: koios

Stop and Remove the Container

To stop Koios:

docker stop koios

To remove the stopped container:

docker rm koios

Stopping or removing the container does not affect your data — all databases, media, logs, certificates, and credentials are stored in Docker volumes and will be available when you start a new container.

View Container Logs

If you started the container with Stream logs to stdout enabled, follow the output with:

docker logs -f koios

Press Ctrl+C to stop following the log output.

What's Next

• Licensing Koios — activate your Koios license
• Environment Variables — customize network ports, TLS, performance, logging, and more