origo
  1. Home
  2. /
  3. Origo OS
  4. /
  5. Guides
  6. /
  7. Build a Private Cloud...

Build a Private Cloud at Hetzner

This tutorial shows you how to install Origo OS on a single server at the German vendor Hetzner.
Hetzner let’s you rent used enterprise server hardware installed in their data centers at low rates and acces it over the Internet.

Please observe that Origo is in no way affiliated with Hetzner, and Origo OS is not in any way approved by, recommended by or authorized by Hetzner.
Origo OS installs services and makes modifications to the network and optionally the storage configuration of the hardware it is installed on. For this reason we recommend that you first get to know Origo OS by installing on non-critical hardware. To be clear – we make no guarantees regarding the functionality, usefulness or security of this software. Origo OS may cause data loss, proceed at your own risk.

Objectives

  • Provision a dedicated, physical server at Hetzner and Install Origo OS remotely over the Internet

Prerequisites

  • An account with Hetzner
  • Solid Internet connectivity

Recommendations

Step 1. Order the Server

We ordered a server from Hetzner’s auction with:

  • 12 CPU cores
  • 128 GB RAM
  • Price: ~€70/month

During the order, we added our public SSH key, so we could log in easily afterwards.

About 15 minutes the server was available and running Hetzner’s rescue system (a temporary Debian environment).

  • Choose and order a server

Step 2. Install Ubuntu

In the Hetzner control panel, we then chose to install Ubuntu 22.04 and rebooted the server from the ssh terminal

  • Select Ubuntu 22.04

Step 3. Order Public IP Addresses

To make services accessible from the internet, order additional IP addresses.

We ordered a /29 subnet (8 IPv4 addresses).
These were ready within a few minutes. From your server’s IPs tab, note down the domain name Hetzner has assigned to your server.

  • Choose how many IP addresses you ned

Step 4. Install Origo OS

If you don’t already have an account on origo.io, create one first.

Now ssh to your server as root again. Because the installation takes a long time, start by installing screen:

apt install screen

Then start the installation inside a screen session:

screen 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 | sh webmin-setup-repo.sh && sudo apt update && sudo apt install stabile

You can leave the screen session running in the background by typing ctrl-a-d and return to it by typing “screen -dr” in a terminal.
During installation, you will be asked:

  1. Whether to use a Let’s Encrypt certificate.
    • You can say yes, and use the domain Hetzner assigned to your server, or say no, and live with the browser SSL warnings.
  3. To enter your Origo account email and set a password.
    • Use the same email you registered on origo.io with.
    • If you have not registered with Origo and do not want to use Origo services, enter any email address.
  • Origo OS can fetch a certificate for you

Step 5. Open the Origo Dashboard and configure Origo OS

Go to:

https://<your-server-domain-or-ip>

and log in with the credentials you configured above.

Then from the dashboard:

  1. Assign the new IP address range to Origo OS in the fields “Mapped IP-range”.
  2. Link the server to origo.io.
  3. Check “Download masters” to allow downloading additional service images.
  4. Make sure “Disable SNAT” is unchecked so services are reachable from the internet.

Please note that after installing Origo OS, ssh access from the Internet is locked down for security reasons. To allow ssh access from specific IP addresses, launch the web terminal and edit /etc/hosts.allow and /etc/ssh/sshd_config and add the ip addresses you want access from. Remember to restart the ssh server (systemctl restart ssh).

6. Install Services

To install a service in your new private cloud, start with e.g. OnlyOffice Docspace to get a complete replacement for Microsoft Office and OneDrive:

  1. Click “Install stack…”
  2. In the popup “Stacks available to download…” select the service you want to download and install
  3. Click Download
  4. After download completes, click Install stack… again
  5. In the popup “Select stack to install” select the stack you just downloaded
  6. Click Install

After a few minutes your new service is ready to use.

To install more services, like e.g. a Kubernetes cluster for your developers, repeat the procedure like described in this guide.