Getting the Koios Image
Get the Koios image onto your server before starting the container. If the server has internet access, pull it from the registry. If it does not, install from an offline archive.
Pull the Latest Image
The image is several GB. Download time depends on your internet connection.
Pull a Specific Version
To pin a specific release version:
Replace v1.2.0 with the version you want. Pinning a version is recommended for production, so that upgrades happen when you choose rather than whenever the image is re-pulled.
Verify the Image
Confirm the image was downloaded successfully:
You should see the aiopinc/koios image listed with the appropriate tag.
An image that loaded without a name has no repository to match, so this command returns nothing even though the image is present. That only happens with older offline archives — see below.
Offline Installation
For a server with no internet access, download an offline archive from the customer portal instead. Archives are published per release and per processor architecture, so take the one matching your server: amd64 for a standard x86-64 machine, arm64 for an ARM one. They are several GB compressed.
If you are not sure which you have, ask the server:
x86_64 means take the amd64 archive. aarch64 means take the arm64 one. Loading the wrong architecture appears to succeed and then fails to run, with an error that does not obviously name the cause.
The file name carries both, so an archive sitting on a drive still says which release it holds. The commands below write it as <version>; an archive downloaded some time ago may not carry one, in which case use the name you have.
1. Check the download
Each release publishes the expected checksum alongside the archive. Compare it before going further. A partially transferred archive fails later, during the load, with an error about the archive format rather than about the transfer:
2. Load it
Read what the command prints. It tells you whether there is a further step:
3. Name an unnamed image
Older archives load without a name; the output above is what tells you which kind you have. Give the image its version and point latest at it, using the identifier the load reported:
Replace <version> with the release the archive is for. Both names are worth setting: the version so you can tell releases apart later, and latest because that is what the service configuration refers to.
If you no longer have the load output, unnamed images can be listed on their own:
What's Next
- Running Koios as a Service: recommended for production deployments
- Manually Starting Koios: for development or testing