Installation Overview
This section takes you from nothing to a running, licensed Koios server. It assumes no prior experience with Linux, Docker, or virtual machines — every command you need is written out.
Koios runs on an Ubuntu Server machine, either a virtual machine on a hypervisor you already have or a physical computer. All of Koios runs inside a single container on that machine, and you administer it from a browser on your own computer. Nothing is installed on the machines your operators use.
Before You Start
Gather these four things. Two of them come from someone else, so ask early:
Record your network settings
Enter them here once and every command in this section shows your values instead of placeholders. They are kept in this browser only.
Use your own values
Enter your settings and the commands throughout the installation pages will show them instead of placeholders. They stay in this browser — nothing is sent anywhere, and nothing is saved to Koios.
Two Decisions
Make both before you begin. They change which pages you read.
Virtual machine or physical computer?
A virtual machine is the usual choice, and Hyper-V is our recommendation if you have Windows Server. A physical computer — including a small industrial PC — is equally supported and is often the better answer at a small site or on a plant floor. Choosing a Host covers both and explains what differs.
Does the machine have internet access?
The Path
Follow these in order. Times are rough, and most of the total is unattended downloading.
Steps 1 through 6 are ordinary Ubuntu setup, unrelated to Koios. If you already have an Ubuntu machine with a static address, start at step 7.
A hypervisor console window has no copy and paste, so everything typed there is typed by hand. That is why step 4 sets the machine's address and installs an SSH server: from there on you work from your own computer and paste commands instead of retyping them.
What You End Up With
- Koios reachable at
https://<the static address you chose>from any browser on the network - A login of
admin/koios, which you change immediately - Koios restarting by itself after a crash or a power cut, with no one logged in
- All data held outside the container, so updating Koios never puts it at risk
No Internet on the Machine?
Installing Without Internet Access covers both routes: preparing a virtual disk on a connected computer, which is the one to prefer, and transferring the files by hand.
If Something Goes Wrong
If the Install Goes Wrong collects the failures that actually come up — ports already in use, an image that will not run, a machine that takes two minutes to boot — with the cause and the fix for each.
What's Next
- System Requirements: confirm your machine is suitable