# Installation

Before you start, you need to perform the platform installation steps on your machine, which must be based on a Unix Operating System (preferably Ubuntu) to ensure having full compatibility.


If you do not have a Ubuntu Operating System, you can download the Ubuntu Desktop Long-Term-Supported image here (opens new window).

If you're using a MS Windows machine, and you wish to dual boot Ubuntu and Windows, follow the instructions here (opens new window).

If you're using a MacOS machine, you can dual boot by following the instructions here (opens new window).

Once the Ubuntu Operating System is installed you can go through the installation steps.

At the end of the installation, PlexusLAB platform will be served at the URL http://localhost/plexus/ or http://YOUR_HOST_OR_IP_ADDRESS/plexus/ if your machine is exposed to the Internet.

# Default installation

Open the terminal and enter these commands:

sudo apt install curl -y
bash <(curl https://setup.plexus-automation.com/lab/ubuntu/install.sh)

WarnThe installation will require you to enter your system password at this point


On your terminal, after the installation is done, your password will be displayed. Copy the password to login into PlexusLAB for the first time. Remember to change the password by going into the users page, after the first login.

# Updating version

Open the terminal and enter this command:

bash <(curl https://setup.plexus-automation.com/lab/ubuntu/install.sh) update

The update flag excludes packages update and goes directly to the PlexusLAB update.

WarnWhen asked, enter system password

# Offline installation

# Prerequisites

In case you don't have internet access on your Ubuntu machine, you can still install PlexusLAB.

You must verify that the following requirements are met on your system, by running these commands:

Requirement How to check Notes
Ubuntu OS 18.04 or newer lsb_release -a
Apache 2.4 apache2 -v Any minor version will be fine
Apache status enabled and active sudo systemctl status apache2
unzip unzip -v Any version will be fine
jq jq --version Any version will be fine
SQLite 3 sqlite3 --version Any minor version will be fine
PHP 7.4 or newer php -v PHP 8 is not supported yet Warn
libapache2-mod-php7.4 sudo apachectl -M Enlisted values must contain: php7_module
PHP Modules php -m Enlisted values must contain: bcmath, bz2, intl, gd, mbstring, mysql, zip, curl, sqlite3

# Manual installation steps

If all requirements are satisfied, you can proceed by following the manual installation steps.

Download the offline install script (opens new window) on a device, and move the file on the Ubuntu machine.

Download the latest Plexus (opens new window) version on a device, and move the file on the Ubuntu machine.

If you don't have direct access to the machine, remember you can always push them remotely via ssh with the scp command (opens new window):

scp /local/path/to/offline_install.sh <ubuntu_remote_user>@<ubuntu_ip_address_or_host>:/var/tmp
scp /local/path/to/latest.zip <ubuntu_remote_user>@<ubuntu_ip_address_or_host>:/var/tmp

Now you must operate on the Ubuntu machine, either by directly opening the Terminal application or by connetting remotely via ssh.

# Move to the folder where PlexusLAB will be installed
cd /var/tmp
# Check latest.zip and offline_install.sh exists
ls -la
# Ensure you can execute the script
sudo chmod +x offline_install.sh
# Execute the script and follow the instructions

# Deleting PlexusLAB

sudo apt install curl
bash <(curl https://setup.plexus-automation.com/lab/ubuntu/remove.sh)

AlertAll your project files will be deleted. This is a permanent removal of PlexusLAB and your data

# Retrieving the password

echo $password$(bash /var/www/html/plexus/getpass.sh) | head -n1 | awk '{print $1;}'
Last Updated: 1/20/2022, 4:43:54 PM