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, you can stop the Koios service by running:
sudo service docker.koios stopStep 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.
Step 3: Pull Latest
With Internet Connection
To pull the latest image straight from Docker, you can use the following command:
docker pull aiopinc/koiosEnsure that the image was loaded by running this command, and ensuring the aiopinc/koios:latest is there with the appropriate date:
docker imagesContinue 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:
docker pull aiopinc/koios:latestOnce the image is pulled, run the following command on the same machine to save the image as a tar ball:
docker save aiopinc/koios:latest | gzip > koios_latest.tar.gzMore: 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:
docker load < koios_latest.tar.gzMore: 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:
docker imagesStep 4: Start Koios
Now that the latest image has been pulled, Koios can be started again using:
sudo service docker.koios startOnce Koios has fully started, log in to the webpage and go to System > Information and verify that the version matched the expected latest version.
Step 5: Remove Old Images (Optional)
Once Koios is back up and running, you can remove the previous image by using:
docker image prune -aMake 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/