Configure SlapOS Master

Configure SlapOS Master

Configuring SlapOS Master

SlapOS Master - Configuration

This tutorial will guide through the steps of configuring a newly installed SlapOS Master node. It requires to have the url, login and password returned when the installation finishes.

Table of Content

  • SlapOS Master Configurator

Configuring SlapOS Master

SlapOS Master Configurator

The SlapOS Master is an ERP5 instance with specific business templates providing the functionality to manage users, software releases, hosting subscriptions, usage consumption et al. For more details please refer to the slapos architecture design document.

The following steps include accessing the underlying ERP5 interface to launch the configurator and configuring email settings so that the SlapOS Dashboard works as expected.

Access SlapOS Master ERP5 Interface

ERP5 Interface - Login Screen

Start by going to the URL (https://[IPv4]) provided and append "/erp5/" to the URL which will take you to directly to the ERP5 interface. Login with the username and password the installation script.

Configure Mailhost

Zope Interface - Configure Mailhost

To use the SlapOS Dashboard, users need to register which includes providing an email address (for verification and account activation). It is therefore required to setup the mailhost and site information so emails are correctly forwarded.

Open https://[IPv4]/erp5/MailHost/manage_main to access the mail host configuration in the Zope interface (ERP5 is built on top of Zope) and add the required info. Click Save changes to continue.

Update Email Sender

Zope Interface - COnfigure Mail Sender

Open https://[IPv4]/erp5/manage_propertiesForm and add the fields email_from_name and email_from_adress to send emails from a valid sender and reduce the chance of emails being labelled as spam. Click Save changes to continue.

Launch Configurator

ERP5 Interface - Configure Site

Back in the erp5 interface (https://[IPv4]/erp5/) you can see that the initial ERP5 instance is almost "empty" - it only contains basic features and modules. ERP5 uses so-called business templates (bt5s) to add specific features (such as CRM, project management, etc.). Templates can be added one-by-one or in bundles for which there are various configurators. A configurator for adding the SlapOS Master business templates has already been provided during installation. To run it, click on My Favorites and select Configure my site which will take you to the available configurators.

Launch Configurator

ERP5 Interface - Configurator Menu

Only one configurator should be available. Select it by clicking Install and confirm the installation on the subsequent screen (not pictured) by clicking "install" again.

Configuration Progress

ERP5 Interface - Configuration Progress

There is a progress indicator (which does not show actual progress!) visible for the duration of the configuration. Configuring SlapOS Master may take between 15-60 minutes depending on the server being used.

Configuration Progress

ERP5 Interface - Configuration Finish

The page will update once the configuration has finished. Click on Start Using your new ERP5 System.

SlapOS Master ERP5 Homescreen

ERP5 Interface - Slapos Master ERP5 Homescreen

Back on the homescreen you can see the updated number of modules available after configuration. It is beyond the scope of the SlapOS documentation to introduce the ERP5 interface. However you will be able to find many elements in the list of modules which will be used through the SlapOS Dashboard (such as Computers or Hosting Subscriptions for example). The SlapOS Dashboard is also part of ERP5 and can be found in the Web Sites module. To continue to the SlapOS Master Dashboard as an actual user, you will need to logout of ERP5 to then access the Master Dashboard website. Click on My Favorites and select Logout at the bottom. You can log back in whenever you like using your root login and password.

SlapOS Master Dashboard.Login

ERP5 Interface - Slapos Master Dashboard Login

To access the SlapOS Master Dashboard, append /erp5/web_site_module/hostingjs/ to the URL. You will be forwarded to the Dashboard Login screen.

Thank You

Image Nexedi Office
  • Nexedi GmbH
  • 147 Rue du Ballon
  • 59110 La Madeleine
  • France