Morbit Hub for Linux Installation Guide (beta)

Created by Tim Kefford, Modified on Fri, 6 Feb at 11:27 AM by Tim Kefford

Overview

Morbit Hub for Linux (allows you to deploy a Morbit Hub on any Linux server or device, including Raspberry Pi. The installer handles all dependencies and configuration automatically.

Since this is a beta product, do not use it on production critical environments.

Supported Platforms

Architectures: x86_64, ARM64 (aarch64), ARM 32-bit (armv7l)
Distributions: Ubuntu, Debian, Raspbian, and other Linux distributions
Requirements:
- Root access (sudo)
- Internet connection
- .NET 8 Runtime (installed automatically if missing)
- PowerShell 7 (installed automatically if missing, required for WMI support)

Installation

Run the following command as root:

curl -fsSL https://morbit-files.s3.eu-west-1.amazonaws.com/linux-installer/install.sh | sudo bash

The installer will:

Detect your system architecture
Check for and install required dependencies (.NET 8 Runtime and PowerShell)
Download and install Morbit Hub
Configure and start the systemd service
Display your Hub Key

Pairing Your Hub

Once installation completes, you will see your Hub Key displayed on screen.

To connect this hub to your Morbit network:

Log in to the Portal
Navigate to System > Configuration. Navigate to your Organisation and open the relevant Network
Click 'Add Hub' and enter the Hub Key shown above
The hub will appear in your network once paired

Useful Commands

Command	Description
sudo systemctl status morbithub	Check service status
sudo journalctl -u morbithub -f	View live logs
sudo systemctl stop morbithub	Stop the service
sudo systemctl restart morbithub	Restart the service

Retrieving Your Hub Key

If you need to retrieve your Hub Key after installation:

sudo journalctl -u morbithub | grep 'Hub Key'

Upgrading

To upgrade an existing installation, simply run the install command again. Your Hub Key and configuration will be preserved.

curl -fsSL https://morbit-files.s3.eu-west-1.amazonaws.com/linux-installer/install.sh | sudo bash

Uninstalling

To remove Morbit Hub from your system:

curl -fsSL https://morbit-files.s3.eu-west-1.amazonaws.com/linux-installer/uninstall.sh | sudo bash

Installing Remote Connections for Linux

To install Remote Connections on Linux, please follow the steps in this guide.

Troubleshooting

Service fails to start

Check the logs for error details:

sudo journalctl -u morbithub -n 50

Hub Key not displayed

The Hub Key is generated on first run. If it wasn't displayed during installation, retrieve it using:

sudo journalctl -u morbithub | grep 'Hub Key'

Dependency installation fails

If automatic dependency installation fails, you can install them manually:

.NET 8 Runtime:

curl -fsSL https://dot.net/v1/dotnet-install.sh | bash -s -- --channel 8.0 --runtime dotnet

PowerShell: Visit https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux