Manually Starting Koios

  • Updated on Sep 12, 2025
  • Published on Sep 12, 2025
  • 1 minute(s) read
Prev Next

Starting for the first time

If you would like to start Koios manually using native docker commands, you can run the following command from your terminal. This will ensure Koios starts with the expected settings and will perform as expected.

Windows

For windows, you may need to use a single line command.

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 --restart=always aiopinc/koios:latest

MacOS and Linux

For MacOS and Linux, you can use line continuation characters to make it easier to read.

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 \
  --restart=always \
  aiopinc/koios:latest

Starting again

Once you’ve run the command above to create the container for the first time, Docker will remember these settings and you can either run the following command in your terminal.

docker start koios

Or you can use Docker Desktop and simply press the play button.

Service Restart

If you are relying on Docker Desktop for Koios to run, you need to ensure that it is configured to always run to ensure the Docker Engine is available for Koios to restart.