This tutorial will guide you through the steps of installing a SlapOS Master on Theia to manage a network of computers. Once completed you will have a COMP-ROOT node similar to that of panel.rapid.space, Nexedi's cloud hosting provider, which can then be used as starting point for creating a network of nodes to provide software instances.

Before starting this tutorial, make sure you have read the SlapOS architecture and SlapOS system requirements in order to make yourself familiar with the terminology and overall concepts.

Follow the steps in HowTo Request A Theia Runner Embedded With A Software to request a SlapOS Master software. 

The Embedded Software URL for SlapOS Master Software is

https://lab.nexedi.com/nexedi/slapos/raw/master/software/slapos-master/software.cfg

Check the logs to make sure it has been deployed and installed:

$ tail -f ~/srv/runner/var/log/slapos-node-software.log

$ tail -f ~/srv/runner/var/log/slapos-node-instance.log

This will download, build and install the required packages (ansible, slapos-node, slapos-proxy), configure the computer as a SlapOS standalone node, and deploy SlapOS Master (ERP5) and a Frontend (Apache) service inside. Note, that, as mentioned, in case the required files are not available from binary cache, compilation may take several hours.

Get some help from slapos service to have the connection parameters listed:

$ slapos service list
# OUTPUT
# List of services:
# Embedded Instance https://lab.nexedi.com/nexedi/slapos/raw/master/software/slapos-master/software.cfg
$ slapos service info 'Embedded Instance'

There are some important parameters:

"monitor-setup-url":"https://monitor.app.officejs.com/#page=settings_configurator&url=https://softinst154691.host.vifib.net/public/feeds&username=admin&password=lfhnagev",
"family-default-v6": "https://[2001:67c:1254:53:b362::3c9]:2152", 
"inituser-login": "zope", 
"inituser-password": "tzcrvsio"

You can monitor your Theia instance by monitor-setup-url. If you have '&' in the monitor-setup-url,please replace it to '&'.family-default-v6 is the Backend URL for the SlapOS Master. Copy the IPv6 URL family-default-v6 for the next step. inituser-login is the administrator username and Backend Type of SlapOS Master. inituser-password, apparently, is the password to zope.

Follow the steps to get a free CDN: How to Request a Rapid.Space CDN

Please fill the following fields in the configuration page:

• "Title": this is the title of your frontend, it is just to name the service inside the panel, which will be displayed in the list of Services. It is recommended that name it like your domain.
• "Backend URL" : Set the IPv6(family-default-v6) provided by the request.
• "Backend Type": Set it to "zope"