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).

If Koios has to reach industrial devices, --network host is the better choice — it lets the container talk to them directly.

First Access

Open a browser and navigate to https://<your-server-ip>. Expect a certificate warning on first access, and log in with admin / koios.

See First Access for the full detail, including replacing the built-in certificate.

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.

Logs are written to files inside the container whether or not stdout streaming is on — reach them with docker exec -it koios ls /var/www/koios/logs/.

What's Next

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