Skip to content

Installing and Updating

Installing Thirdlane

Installation Options

Thirdlane Multi Tenant PBX offers flexible deployment. It can be installed on-premises or in the cloud, adapting to various business needs and IT setups, and runs on both bare metal servers and a wide range of virtual environments. This versatility lets Thirdlane integrate seamlessly into different operational landscapes, whether you want the control of on-premises infrastructure or the scalability of cloud-based solutions. A single business simply runs the platform with one tenant - there is no separate product to choose.

The installation process for Thirdlane varies based on the environment, so it’s important to consult the specific documentation for your setup. During installation, you’ll be guided through steps such as disk configuration, setting your server time zone, establishing a root password, and defining network parameters.

Remember to keep a record of your root password; it’s crucial for system management and for your initial access to the Configuration Manager’s web GUI.

Step 1 - Install AlmaLinux

For installing the Thirdlane platform, begin with AlmaLinux 10 (recommended) or AlmaLinux 8, using the minimal ISO from the AlmaLinux repository:

AlmaLinux 10 is the current LTS with a fresh 10-year support window, a modern kernel and toolchain, and the latest security baseline. New deployments should use AlmaLinux 10. AlmaLinux 8 remains fully supported through its EOL.

For cloud installations, opt for an AlmaLinux 10 template (or AlmaLinux 8) provided by your cloud service. The steps are straightforward: Install the OS, configure network settings ensuring internet access, and run the Thirdlane installation script via SSH. After installation, access the GUI using your server address or domain and proceed with the Initial Configuration Wizard in the Thirdlane Configuration Manager.

Already running CentOS, RHEL, AlmaLinux 7, or considering a move from AlmaLinux 8 to 10? Our team can plan and execute the migration with minimal downtime. Contact us to coordinate.

Step 2 - Install Thirdlane

Use AlmaLinux 10 for new installations. The commands below target AlmaLinux 10 (getpbx-el10). To install on AlmaLinux 8 instead, replace el10 with el8 in the URL — but new deployments should standardize on AlmaLinux 10 to align with the current LTS lifecycle.

The standard installer is getpbx-mte (Thirdlane Multi Tenant). A legacy single-tenant installer (getpbx-ste) remains available for existing Single Tenant deployments only - new installations should use getpbx-mte and simply run a single tenant if only one organization is needed.

Both scripts are adopted to cloud installations which usually don’t have a root password - they use SSH keys for ssh access. When getpbx-ste or getpbx-mte script determines that your system root user doesn’t have a password, it creates temporary credentials (superadmin / superadmin ) to login to the newly created server, and at the end of Thirdlane Configuration Manager’s Initial Configuration Wizard you will be able to create admin credentials (superadmin user will be deleted).

Installation scripts also try to simplify domain, HTTPS certificate, and network configuration - when:

  1. Hostname setting of the server is a valid domain - eg. abc.pbxmanager.com.
  2. The domain is properly configured - DNS of abc.pbxmanager.com has A-record with proper ip of the server.

If this criteria is met, Thirdlane Configuration Manager setup wizard will use the simplified scenario - steps with domain and interface configuration will be done automatically - including creation of LetsEncrypt HTTPS certificate.

To download and install Thirdlane run:

curl -o getpbx -s http://lib.thirdlane.com/download/getpbx-el10/getpbx-mte && time sudo bash getpbx

Legacy Single Tenant (existing installs only)

The single-tenant package remains available for existing Single Tenant deployments. New installations should use the Multi Tenant package above and simply run a single tenant if only one organization is needed. To download and install the legacy Single Tenant package run:

curl -o getpbx -s http://lib.thirdlane.com/download/getpbx-el10/getpbx-ste && time sudo bash getpbx

Installing Thirdlane Connect

Thirdlane Connect for Windows and Mac desktops can be downloaded using your browser based Thirdlane Connect by going to Settings > Downloads. Android version of Thirdlane Connect is available on Google Play --- link. iOS (iPhone and IPad) version of Thirdlane Connect is available on App Store — link.

Software Updates

You should keep your software current at all times. Whichever method you use, make sure that you have a working backup or a snapshot of your server before updating.

There are two ways to update your Thirdlane system:

Update using Configuration Manager

In Configuration Manager, go to Tools → Update Manager to check for and apply updates from the web GUI. The Update Manager lists available updates with their release notes, and the update process handles database migrations, file updates, and service restarts for you. This is the recommended method for most deployments. For the full workflow - including backups and zero-downtime rolling updates in cluster deployments - see Updates and Maintenance.

Update using yum

To install the latest packages from the Thirdlane repositories directly, at the shell prompt run:

yum clean all
yum update

Please contact Thirdlane if you need any assistance with the update.

To avoid software conflicts and incompatible versions of software do not enable any non Thirdlane RPM repositories when performing updates.