---
title: "Manually Starting Koios"
slug: "manually-starting-koios"
updated: 2025-09-12T14:31:04Z
published: 2025-09-12T14:31:04Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai-op.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manually Starting Koios

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

```shell
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.

```bash
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.

```shell
docker start koios
```

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

> [!NOTE]
> 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.