Date: December 2022
Make sure you have downloaded layline.io for your respective operating system. You can check and download the latest version from our main website here (opens new window).
On linux, or MacOS you can also download via curl:
Depending on your CPU architecture:
curl -O https://download.layline.io/releases/layline-linux-amd64-1.0.2.sh
curl -O https://download.layline.io/releases/layline-linux-arm-1.0.2.sh
You can check recent changes in our Release Notes.
Let's go ahead and run the installation now.
# Windows / MacOS
Run the installer:
Hit next until you see:
These are standard communication ports required by layline.io. If they don't collide with anything you are already running, then just leave the defaults.
The installation should finish without issues.
You must have libfreetype6 installed. If it is not installed you need to so prior to running the installer, or else it will fail with an error:
Next, pick and run the installer for your target processor architecture:
Accept the defaults or change according to your environment.
root@b8a9e28ce031:/layline# ./layline-linux-amd64-1.0.2.sh Unpacking JRE ... Starting Installer ... This will install layline.io on your computer. OK [o, Enter], Cancel [c] Click Next to continue, or Cancel to exit Setup. Select the folder where you would like layline.io to be installed, then click Next. Where should layline.io be installed? [/usr/local/layline] Choose the listening ports for the layline components Config Server REST Port  Reactive Engine REST Port  Reactive Engine Streams Port  Create symlinks? Yes [y, Enter], No [n] Select the folder where you would like layline.io to create symlinks, then click Next. [/usr/local/bin] Extracting files ... Setup has finished installing layline.io on your computer.
If you want to uninstall layline.io, you can run the respective uninstallers on Windows or MacOS.
On Linux there is an uninstaller in your installation directory:
root@b8a9e28ce031:/usr/local/layline# ./uninstall Are you sure you want to completely remove layline.io and all of its components? Yes [y, Enter], No [n] Uninstalling layline.io 1.0.2 ... layline.io was successfully removed from your computer. Finishing uninstallation ...
Project data will not be uninstalled In case you have created some Projects with layline.io, these will remain and must be deleted manually.
# Understand moving parts
Let's first understand what needs to run at a minimum. layline.io consists of three major elements:
# Configuration Server
A process which
- Serves the Web-based Configuration Center
- Handles some configuration support services
- Manages the Project storage
# Configuration Center
A web-based UI which is used for
- the configuration of layline.io Projects
- the deployment of Projects to a Reactive Engine / Reactive Engine Cluster
- the monitoring of one or more Reactive Engine Clusters
# Reactive Engine
A process which
- executes a Project and Project Workflows
- is spawned 1..n times on 1..n nodes.
# Starting everything
# Starting the Config Server
# Start the Reactive Engine
# Open the Config Center Web UI
It's time to check if we can start the web-based Configuration Center.
The Configuration Center is served by the Configuration Server. So make sure that it is up and running.
Open a web browser and enter the url:
In case you have installed the Configuration Server on another machine reachable through a different url, then enter the respective url instead of
Should you have changed the port number during installation, you also need to change the port number to what you have set it to.
You should be taken to the login page:
The default login is
admin with password
admin. Once logged in, you should see this:
# Starting issues
Issues when upgrading from previous version
Should you be upgrading a previously installed version, there is a chance that you may encounter starting issues with the Configuration Server and/or Reactive Engine. The reason being that there are still old configuration elements lingering around. The easiest way to fix the issues would be to follow these steps:
- Uninstall layline.io
- Locate your layline configuration directory:
- Delete the above directory (Keep a backup until you know everything runs well post fix)
- Reinstall layline.io
The problem should be fixed.
Can't find what you are looking for?
Please note, that the creation of the online documentation is Work-In-Progress. It is constantly being updated. Should you have questions or suggestions, please don't hesitate to contact us at firstname.lastname@example.org.