{"id":7697,"date":"2020-10-21T22:41:27","date_gmt":"2020-10-21T22:41:27","guid":{"rendered":"https:\/\/www.origo.io\/info\/?page_id=7697"},"modified":"2025-11-01T18:16:25","modified_gmt":"2025-11-01T17:16:25","slug":"single-node-quick-start","status":"publish","type":"page","link":"https:\/\/origo.systems\/info\/stabiledocs\/single-node-quick-start\/","title":{"rendered":"Quick-Start"},"content":{"rendered":"\n<p>This tutorial shows you how to install Origo OS on a single workstation or server.<\/p>\n\n\n\n<div class=\"alert alert-info\">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, ideally&nbsp;a discarded workstation or server, that is not in active use and does not store any data that can not be lost.\nTo be clear \u2013 we make no guarantees regarding the functionality, usefulness or security of this software. Origo OS may cause data loss, proceed at your own risk.<\/div>\n\n\n\n<h4>Objectives<\/h4>\n<ul>\n<li>Install Origo OS to a single workstation or server<\/li>\n<\/ul>\n<h4>Prerequisites<\/h4>\n<ul>\n<li>A x86 workstation or server that can be used for testing and development purposes<\/li>\n<li>A minimum of 100 GB available storage<\/li>\n<li>Solid Internet connectivity<\/li>\n<\/ul>\n<h4>Recomendations<\/h4>\n<ul>\n<li>2 storage devices or more (SSD&#8217;s, hard drives or raid devices)\n<ul>\n<li>A single disk will work, but with two, images and backups can be stored on dedicated, separated devices<\/li>\n<li>To enable ZFS backup, you must have two storage devices besides the boot device.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>Installation options<\/h4>\n<p>There are two ways to install Origo OS:<\/p>\n<ol>\n<li>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!<\/li>\n<li>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.<\/li>\n<\/ol>\n\n\n\n<h4>Option 1) Install Origo OS using the ISO to a computer (primary disk is wiped)<\/h4>\n<p><em>Please note, that the &#8220;primary disk&#8221; 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.<\/em><\/p>\n<ol>\n<li><a href=\"https:\/\/www.origo.io\/signup\" target=\"_blank\" rel=\"noopener noreferrer\">Sign up<\/a> for the Origo Registry\n<ul style=\"list-style-type: circle;\">\n<li>This step is optional, but necessary if you want to link your installation with Origo Registry.<\/li>\n<\/ul>\n<\/li>\n<li>Download the ISO\n<ul style=\"list-style-type: circle;\">\n<li>The ISO can be downloaded here: <a href=\"https:\/\/apt.origo.io\/archives\/stabile-bionic-auto.iso\" target=\"_blank\" rel=\"noopener noreferrer\">https:\/\/apt.origo.io\/archives\/stabile-bionic-auto.iso<\/a><\/li>\n<\/ul>\n<\/li>\n<li>Make a bootable USB stick from the ISO\n<ul style=\"list-style-type: circle;\">\n<li>Use your preferred tool for creating a bootable USB drive. We like this: <a href=\"https:\/\/www.balena.io\/etcher\/\" target=\"_blank\" rel=\"noopener\">https:\/\/www.balena.io\/etcher\/<\/a><\/li>\n<\/ul>\n<\/li>\n<li>Boot from the USB stick and install\n<ul style=\"list-style-type: circle;\">\n<li>Put the USB stick in the computer you want to install on, reboot, hold F7 and select the USB drive as boot device.<\/li>\n<li>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.<\/li>\n<li>Please note that the computer must be able to connect to the Internet for downloading software during installation!<\/li>\n<li><span lang=\"EN-US\">&#8220;installing kickseed&#8221; may take a while, up to 10 minutes, depending on your Internet connection and server ressources<\/span><\/li>\n<li>After succesful installation, your computer should power off. Remove the USB stick and turn the computer on again.<\/li>\n<\/ul>\n<\/li>\n<li>Log in to your computer&#8217;s text console with username &#8220;stabile&#8221; and password &#8220;sunshine&#8221;.<\/li>\n<li>Change the account password into a secure password of you choosing by typing <code>passwd<\/code><\/li>\n<li>Type: <code>sudo dpkg-reconfigure stabile<\/code> and set username and password for the administrative account\n<ul style=\"list-style-type: circle;\">\n<li>Please use the the username you signed up with in step 1.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h4>Option 2) Install Origo OS to a computer already running Ubuntu 22.04 (nothing is wiped)<\/h4>\n<ol>\n<li><a href=\"https:\/\/www.origo.io\/signup\" target=\"_blank\" rel=\"noopener noreferrer\">Sign up<\/a> for the Origo Registry\n<ul style=\"list-style-type: circle;\">\n<li>This step is optional, but necessary if you want to link your Stabile installation with Stabile Registry.<\/li>\n<\/ul>\n<\/li>\n<li>Configure your software repositories\n<ul style=\"list-style-type: circle;\">\n<li>Your user account must have sudo privileges!<\/li>\n<li>To add our gpg key to your keyring, in a terminal type: <code>curl --silent https:\/\/apt.origo.io\/archives\/origo.key | sudo apt-key add -<\/code>\n<ul style=\"list-style-type: circle;\">\n<li>Type in your account password if asked by sudo<\/li>\n<\/ul>\n<\/li>\n<li>To add our repository to your sources, type: <code>sudo bash -c 'echo \"deb [arch=amd64] http:\/\/apt.origo.io\/archives jammy stabile\" &gt; \"\/etc\/apt\/sources.list.d\/stabile.list\"'<\/code><\/li>\n<li>To add the Webmin repository, type:<br \/><code>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<\/code><\/li>\n<li>To update apt, type: <code>sudo apt update<\/code><\/li>\n<\/ul>\n<\/li>\n<li>Install the Stabile package<br \/>\n<ul style=\"list-style-type: circle;\">\n<li>To install Origo OS, type: <code>sudo apt install stabile<\/code><\/li>\n<li>When asked to set user name and password for the administrative account, please use the the username you signed up with in step 1.<\/li>\n<li>And if you are in a hurry, here are the above commands on a single line: <code>curl --silent https:\/\/apt.origo.io\/archives\/origo.key | sudo apt-key add - &amp;&amp; sudo bash -c 'echo \"deb [arch=amd64] http:\/\/apt.origo.io\/archives jammy stabile\" &gt; \"\/etc\/apt\/sources.list.d\/stabile.list\"' &amp;&amp; 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 &amp;&amp; sudo apt update &amp;&amp; sudo apt install stabile<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h4>3) Complete the installation<\/h4>\n<ul style=\"list-style-type: circle;\">\n<li>Now fire up a browser, and point it to: <code>https:\/\/your.computers.ip-address\/stabile<\/code>\n<ul style=\"list-style-type: circle;\">\n<li>Log in with the username and password you just set<\/li>\n<\/ul>\n<\/li>\n<li>In the dashboard change the &#8220;Mapped IP-range&#8221; field to match your local IP address segment\n<ul style=\"list-style-type: circle;\">\n<li>Example: If your computer&#8217;s IP address is e.g. 192.168.1.24, you could set the range to e.g. 192.168.0.201 \u2192 192.168.0.210<\/li>\n<li>Important: Make sure the IP addresses in the range you assign are not in active use<\/li>\n<\/ul>\n<\/li>\n<li>To access the API browser, go to:<code>https:\/\/your.computers.ip-address\/stabile\/api<\/code><\/li>\n<\/ul>\n<p>Hopefully you should now have a working Origo OS installation, but remember, this is beta software, problems are expected.<br \/>The suggested next steps are to continue with one or more of <a href=\"\/info\/stabiledocs\/guides\/\">the guides<\/a> that make sense to your situation and setup.<br \/>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!<\/p>\n\n\n\n<!-- div class=\"alert alert-warning\">\nOrigo OS is currently in public beta. You should not download and install Origo OS 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. Origo OS may cause data loss, proceed at your own risk.\n\n<div>If you want to join the beta program, submit your email address below. Once Stabile is released, the repository and the registry will be made more widely available.<\/div>\n<div class=\"widget_wysija_cont php_wysija\">\n<form id=\"form-wysija-php5f8d78d0068a9-1\" class=\"widget_wysija php_wysija\" action=\"#wysija\" method=\"post\">\n<input class=\"wysija-input validate[required,custom[email]]\" style=\"width: 360px; margin-top:20px; background-color:#FEFEFE; display: inline-block;\" title=\"Email\" name=\"wysija[user][email]\" type=\"text\" value=\"\" placeholder=\"Your email address\"\/>\n<span class=\"abs-req\">\n<input class=\"wysija-input validated[abs][email]\" name=\"wysija[user][abs][email]\" type=\"text\" value=\"\"\/>\n<\/span>\n<input class=\"wysija-submit wysija-submit-field btn btn-success\" style=\"vertical-align: baseline; margin-left: 10px; margin-top: 6px; display: inline-block;\" type=\"submit\" value=\"join the beta program\"\/> <input name=\"form_id\" type=\"hidden\" value=\"1\"\/> <input name=\"action\" type=\"hidden\" value=\"save\"\/> <input name=\"controller\" type=\"hidden\" value=\"subscribers\"\/>\n<input name=\"wysija-page\" type=\"hidden\" value=\"1\"\/> <input name=\"wysija[user_list][list_ids]\" type=\"hidden\" value=\"9\"\/>\n<\/form>\n<div id=\"msg-form-wysija-php5f8d78d0068a9-1\" class=\"wysija-msg ajax\" style=\"margin-top:20px;\"><\/div>\n<\/div> -->\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n","protected":false},"excerpt":{"rendered":"<p>This tutorial shows you how to install Origo OS on a single workstation or server. 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<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":729,"menu_order":24,"comment_status":"open","ping_status":"closed","template":"page-leftsb.php","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-7697","page","type-page","status-publish","hentry"],"acf":[],"featured_image_src":null,"featured_image_src_square":null,"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/pages\/7697","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/comments?post=7697"}],"version-history":[{"count":160,"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/pages\/7697\/revisions"}],"predecessor-version":[{"id":15836,"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/pages\/7697\/revisions\/15836"}],"up":[{"embeddable":true,"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/pages\/729"}],"wp:attachment":[{"href":"https:\/\/origo.systems\/info\/wp-json\/wp\/v2\/media?parent=7697"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}