# How To Instantiate Frontend Slave

This document explains how to instantiate a Frontend Slave which can provide a user-friendly URL for another service running on a SlapOS network.

It will explain the different instantiation parameters. Please refer to other documents on add a software to the SlapOS Master catalog or supplying/installing a software

# Table of Content

- Frontend Slave Instance Configuration

# Frontend (Caddy) Slave Configuration

The process of installing (supplying) a software and providing it as a service (instantiation) are the same for all software. However during instantiation each instance can be configured differently.

This section will cover the specific configuration parameters used for a Frontend Slave used for example during installation of COMP-0 as it will provide a frontend-url such as

    master.slaptest.erp5.net

for the Dashboard on

    https://54.37.31.10/erp5/web_site_module/hostingjs/

Note that a Frontend slave is an instance of a previously instantiated Frontend!

# Frontend Slave Configuration Parameters

After selecting Services, Adding a new service, selecting Frontend and the latest release, you should reach the Frontend configuration menu.

Select Custom Personal (Slave) and give your Frontend a recognizable name. Then add the Backend Url you want this Frontend to connect to. In the screenshot pictured, it is the url to a SlapOS Master Dashboard. The backend url

    https://54.37.31.10/erp5/web_site_module/hostingjs/

points to this Dashboard. Set Custom Domain and Server Alias to the domain you want to use

    master.slaptest.erp5.net

then scroll down to the bottom of the page and (don't forget) to select the computer to provide the Frontend slave.

Click Proceed to continue and request instantiation.

# Frontend Slave Instantiation

You will be forwarded back to the list of deployed services. Note that you might have to refresh the page for your new instance to appear. Once you can see it, click on entry to open the connection parameters.

You can follow the compilation by looking at the `slapos-node-software.log` using:

    # tail opt/slapos/log/slapos-node-software.log -f

# Frontend Slave Connection Parameters

Note, it might take a few minutes for the instance to become available. Refresh the page from time to time until the connection parameter table displays parameteres. Once the Secure Access entry shows the requested URL, the Frontend Slave is setup and working.

# Frontend Slave Running

If you go to your requested URL (`master.slaptest.erp5.net`) you can see that it points to the selected backend URL.

# Thank You

- Nexedi SA
- 147 Rue du Ballon
- 59110 La Madeleine
- France

- nexedi.com/contact