---
title: "Updating the Koios Version"
slug: "updating-the-koios-version"
updated: 2025-01-26T21:29:31Z
published: 2025-01-26T21:29:31Z
canonical: "docs.ai-op.com/updating-the-koios-version"
---

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

# Updating the Koios Version

To update Koios, start by ensuring your control system is in a safe state to operate without Koios temporarily. When ready, follow the steps below:

#### Step 1: Stop Koios

If you are using our [systemd service file](/v1/docs/setting-up-the-koios-service), you can stop the Koios service by running:

```shell
sudo service docker.koios stop
```

#### Step 2: Backup Volumes (Recommended)

This step isn’t necessary but is highly recommended. If you are using Linux, this can be done by following our [backup guide.](/v1/docs/backing-up-volumes)

#### Step 3: Pull Latest

##### With Internet Connection

To pull the latest image straight from Docker, you can use the following command:

```shell
docker pull aiopinc/koios
```

Ensure that the image was loaded by running this command, and ensuring the `aiopinc/koios:latest` is there with the appropriate date:

```shell
docker images
```

*Continue to Step 4.*

##### Without Internet Connection

If this machine does not have access to the internet, you will need to pull the image from another machine that does have an internet connection **as well as** Docker installed and running.

From that machine, run:

```shell
docker pull aiopinc/koios:latest
```

Once the image is pulled, run the following command on the same machine to save the image as a tar ball:

```shell
docker save aiopinc/koios:latest | gzip > koios_latest.tar.gz
```

More: [https://docs.docker.com/reference/cli/docker/image/save/#save-an-image-to-a-targz-file-using-gzip](https://docs.docker.com/reference/cli/docker/image/save/#save-an-image-to-a-targz-file-using-gzip)

From here, copy the tar file onto an external drive and paste it onto the offline machine. Once the tar file is on the desired machine, run this command to load the latest Koios image:

```shell
docker load < koios_latest.tar.gz
```

More: [https://docs.docker.com/reference/cli/docker/image/load/#load-images-from-stdin](https://docs.docker.com/reference/cli/docker/image/load/#load-images-from-stdin)

Ensure that the image was loaded by running this command, and ensuring the `aiopinc/koios:latest` is there with the appropriate date:

```shell
docker images
```

#### Step 4: Start Koios

Now that the latest image has been pulled, Koios can be started again using:

```shell
sudo service docker.koios start
```

Once Koios has fully started, log in to the webpage and go to `System` > `Information` and verify that the version matched the expected [latest version](/v1/docs/release-notes).

#### Step 5: Remove Old Images (Optional)

Once Koios is back up and running, you can remove the previous image by using:

```shell
docker image prune -a
```

> [!WARNING]
> Make Sure Koios is Running
> 
> Using the -a command will remove any image not associated with a container. If Koios is not running, it’s container may not exist yet and this could cause you to delete the new image you just pulled.

More: [https://docs.docker.com/reference/cli/docker/image/prune/](https://docs.docker.com/reference/cli/docker/image/prune/)