Single Node Quick-Start

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

Stabile is currently in public beta. This means you should not download and install Stabile unless you are completely aware of what this entails. To be clear – we make no guarantees regarding the functionality, usefulness or security of this software. Stabile may cause data loss – proceed at your own risk.
Please understand that Stabile makes pretty heavy modifications to the network and possibly the storage configuration of the hardware it is installed on. For this reason we only recommend installing Stabile on non-critical hardware, ideally a discarded workstation or server, that is not in active use and does not store any data that can not be lost.

To join the beta program, please drop us a line with the IP address you access our software repository from, we will then add this to our access list. Once Stabile is released, we will of course make the repository available from anywhere.

Ask for access to the software repository

 

Objectives

  • Install Stabile 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, backups can be stored on a separate device
    • To enable ZFS backup, you must have two storage devices besides the boot device.

Installation options

There are two ways to install Stabile:

  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 Stabile 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 Stabile using apt. This will not erase any storage (unless you explicitly ask Stabile to do so), but it will make pretty heavy changes to network configuration.

1) Install Stabile using the ISO

  1. Sign up for the Stabile Registry
    • This step is optional, but necessary if you want to link your Stabile installation with Stabile Registry.
  2. Download the ISO
  3. Make a bootable USB stick from the ISO
  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 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!
    • 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 Stabile account
    • Please use the the username you signed up with in step 1.

2) Install Stabile on a computer already running Ubuntu 18.04

  1. Sign up for the Stabile 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 bionic stabile" > "/etc/apt/sources.list.d/stabile.list"'
    • To update apt, type: sudo apt update
  3. Install the Stabile package
    • To install Stabile, type: sudo apt install stabile
    • When asked to set user name and password for the administrative Stabile account, please use the the username you signed up with in step 1.

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 Stabile 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!

Leave a Comment

Your email address will not be published. Required fields are marked *

*






This site uses Akismet to reduce spam. Learn how your comment data is processed.

Products

Ressources

Company