Quick-Start

This tutorial shows you how to install Origo OS on a single workstation or server.

Objectives

• Install Origo OS to a single workstation or server

Prerequisites

• A x86 workstation or server that can be used for testing and development purposes
• A minimum of 100 GB available storage
• Solid Internet connectivity

Recomendations

• 2 storage devices or more (SSD’s, hard drives or raid devices)
  • A single disk will work, but with two, images and backups can be stored on dedicated, separated devices
  • To enable ZFS backup, you must have two storage devices besides the boot device.

Installation options

There are two ways to install Origo OS:

1. If you have a computer available whose main drive may be formatted, you can simply download the ISO image, boot from it, and let Origo OS be installed automatically. Please note that this will completely erase all data on the main drive!
2. If you have a computer already running Ubuntu 18.04, you can install Origo OS using apt. This will not erase any storage (unless you explicitly ask Origo OS to do so), but it will make pretty heavy changes to network configuration.

Option 1) Install Origo OS using the ISO to a computer (primary disk is wiped)

Please note, that the “primary disk” is the one identified as /dev/sda, which will typically be the one attached to the first SATA port. If you are unsure which disk this is, please disconnect all disks except the one you want to use as primary/boot disk before proceeding.

1. Sign up for the Origo Registry
   • This step is optional, but necessary if you want to link your installation with Origo Registry.
2. Download the ISO
   • The ISO can be downloaded here: https://apt.origo.io/archives/stabile-bionic-auto.iso
3. Make a bootable USB stick from the ISO
   • Use your preferred tool for creating a bootable USB drive. We like this: https://www.balena.io/etcher/
4. Boot from the USB stick and install
   • Put the USB stick in the computer you want to install on, reboot, hold F7 and select the USB drive as boot device.
   • If you are ABSOLUTELY sure, that you are OK with wiping the primary hard drive in the computer, proceed by typing return, and then wait approximately 10 minutes, depending on the speed of your Internet connection and your hard drive / SSD.
   • Please note that the computer must be able to connect to the Internet for downloading software during installation!
   • “installing kickseed” may take a while, up to 10 minutes, depending on your Internet connection and server ressources
   • After succesful installation, your computer should power off. Remove the USB stick and turn the computer on again.
5. Log in to your computer’s text console with username “stabile” and password “sunshine”.
6. Change the account password into a secure password of you choosing by typing passwd
7. Type: sudo dpkg-reconfigure stabile and set username and password for the administrative account
   • Please use the the username you signed up with in step 1.

Option 2) Install Origo OS to a computer already running Ubuntu 22.04 (nothing is wiped)

1. Sign up for the Origo Registry
   • This step is optional, but necessary if you want to link your Stabile installation with Stabile Registry.
2. Configure your software repositories
   • Your user account must have sudo privileges!
   • To add our gpg key to your keyring, in a terminal type: curl --silent https://apt.origo.io/archives/origo.key | sudo apt-key add -
     • Type in your account password if asked by sudo
   • To add our repository to your sources, type: sudo bash -c 'echo "deb [arch=amd64] http://apt.origo.io/archives jammy stabile" > "/etc/apt/sources.list.d/stabile.list"'
   • To add the Webmin repository, type:
     curl -o webmin-setup-repo.sh https://raw.githubusercontent.com/webmin/webmin/master/webmin-setup-repo.sh ; sudo echo y | sudo sh webmin-setup-repo.sh
   • To update apt, type: sudo apt update
3. Install the Stabile package
   
   • To install Origo OS, type: sudo apt install stabile
   • When asked to set user name and password for the administrative account, please use the the username you signed up with in step 1.
   • And if you are in a hurry, here are the above commands on a single line: curl --silent https://apt.origo.io/archives/origo.key | sudo apt-key add - && sudo bash -c 'echo "deb [arch=amd64] http://apt.origo.io/archives jammy stabile" > "/etc/apt/sources.list.d/stabile.list"' && curl -o webmin-setup-repo.sh https://raw.githubusercontent.com/webmin/webmin/master/webmin-setup-repo.sh ; sudo echo y | sudo sh webmin-setup-repo.sh && sudo apt update && sudo apt install stabile

3) Complete the installation

• Now fire up a browser, and point it to: https://your.computers.ip-address/stabile
  • Log in with the username and password you just set
• In the dashboard change the “Mapped IP-range” field to match your local IP address segment
  • Example: If your computer’s IP address is e.g. 192.168.1.24, you could set the range to e.g. 192.168.0.201 → 192.168.0.210
  • Important: Make sure the IP addresses in the range you assign are not in active use
• To access the API browser, go to:https://your.computers.ip-address/stabile/api

Hopefully you should now have a working Origo OS installation, but remember, this is beta software, problems are expected.
The suggested next steps are to continue with one or more of the guides that make sense to your situation and setup.
If and when you run into stuff that does not work, or does not work as intended or as expected, please leave a comment below to help us fix it. Thanks for your help!