Skip to main content

Morio Client Installation Guide

This guide covers the installation of the Morio client. Once installed, refer to the Morio Client Configuration Guide for what to do next.

Quick Start

To install the Morio client, run the following command from an account with sudo permissions:

curl -fsSL https://install.morio.it/client | bash
note

We currently provide a morio-client package for Debian-based Linux systems, both amd64 and arm64 packages are available from apt.repo.morio.it .

Support for RPM-based linux distributions (like RedHat), as well as macOS and Windows are on our roadmap.

Before you start​

Morio Client vs Morio Cluster Node​

This guide covers the installation of the Morio client, also known as installing morio-client.

For installation of a Morio cluster node, please refer to the Morio Cluster Node Installation Guide.

Morio Release Channels​

Morio releases are provided through different channels that each serve their specific purpose. You should use the stable channel unless you have specific reasons not to.

📦 Stable

The stable channel provides stable releases that have been tested and gone through an incubation period in the canary channel.

tip

The stable channel is the default release channel. We recommend to use stable unless you have specific reasons not to.

🐣 Canary

The canary channel provides early access to releases. When no issues come up during a canary release's incubation period, it is promoted to stable.

The canary releases allow you to test an upcoming stable release in your specific environment, and limits the blast radius in case a problem is not caught in testing. For this reason, we recommend to run the canary release on a staging instance.

💣 Testing

The testing channel is not intended to be used for real deployments. Instead, this channel is used for our integration tests, as well as by developers of and contributors to Morio to validate fixes or new features.

When a release in testing is validated, it graduates to canary.

Filesystem Layout​

The Morio client uses one folder for configuration, one for data, and another one for its logs. By default, they are laid out as such:

  • Configuration resides in /etc/morio.
  • Data resides in /var/lib/morio.
  • Logs are written to /var/log/morio.
warning

If you are installing the Morio client on a Morio Cluster Node, note that each of these locations will have a moriod subfolder holding config/data/logs for the Cluster Node (not the client).

Install the Morio Client​

There are two ways to install the Morio Client:

We recommend using the installer script.

Install the Morio Client via the installer script​

This is the recommended way to install the Morio Client

To install Morio, run this command as a user with sudo permissions:

curl -fsSL https://install.morio.it/client | bash

This will run through the following steps:

Alternatively, you can run all of these steps manually, as outlined below.

Configure the client

Once installed, refer to the Morio Client Configuration Guide for what to do next.

Install the Morio Client from packages​

To install the Morio Client from packages, we will go through the same steps as the install script, but instead run them by hand:

Determine the package type​

We provide .deb packages for APT-based systems, like Debian or Ubuntu.

warning

We will will also provide .rpm packages for RPM-based systems like RedHat, RockyLinux, or Fedora in the future, but currently we do not yet provide those.

To see if you are on an APT-based system, you can run this command:

apt -h

If you get a bunch of output about apt packages, you are on an APT-based system. If not, you are probably on an RPM-based system.

Download and install the morio-repo package​

Download the morio-repo package, and then install it:

curl https://apt.repo.morio.it/setup-morio-repo.deb -o ./setup-morio-repo.deb
sudo apt install -y ./setup-morio-repo.deb

The first line downloads the package from these URLS:

The second line installs it.

Update the list of available software​

The morio-repo package we just installed adds a new software repository. Before we can install software from it, we need to update the list of available packages:

sudo apt update

Install the morio-client package​

Now we can install the morio-client package:

sudo apt install -y morio-client
Configure the client

Once installed, refer to the Morio Client Configuration Guide for what to do next.

Uninstall the Morio Client​

To uninstall the Morio Client and remove it from your system, follow these steps:

  • Stop all agents:
sudo morio stop
warning

The next steps are not safe to run on a Morio Cluster Node if you want to remove only the client and keep the Cluster Node

  • Remove the morio-repo and morio-client packages:
sudo apt purge -y morio-repo moriod
  • Remove the 3 folders holding configuration, data, and logs:
sudo rm -rf /etc/morio /var/log/morio /var/lib/morio