Installing MOJO¶

This guide walks you through installing and running MOJO Platform on your Linux server.

System Requirements¶

MOJO works best on a fresh Linux installation. The platform has been thoroughly tested on the following distributions:

Distribution Type	Supported Versions
Debian-based	Ubuntu 22.04, Ubuntu 24.04, Debian 12 (Bookworm), Debian 13 (Trixie), Linux Mint
RedHat-based	RHEL 9, RHEL 10, CentOS, Alma Linux, Rocky Linux

While other Linux distributions may work, they haven't been extensively tested. If you're starting from scratch, we recommend Ubuntu 24.04 or Debian 12 for the best experience.

Hardware Requirements:

Resource	Requirement
Memory	Minimum 16GB RAM (recommended)
Disk Space	At least 80GB free space
Network	A network interface with internet access

Disk Space Note

Depending on where you choose to store your ISO files and drivers, you may require additional disk space based on your needs.

While a dedicated machine is recommended for the MOJO Platform, it's not strictly required. All changes will be contained in your chosen installation directory and the /tmp folder.

For more information about how MOJO works, please visit our documentation page.

Prerequisites¶

Container Runtime¶

MOJO requires either Docker or Podman to run. If you don't have a container runtime installed, the MOJO installer will offer to install Docker for you during setup.

You can also install Docker manually before running the MOJO installer:

OS	Installation Guide
Debian-based (Ubuntu, Mint)	Docker for Debian
RedHat-based (RHEL, CentOS)	Docker for CentOS

Podman Support

On RedHat-based systems, MOJO also supports Podman as an alternative to Docker. The installer will automatically detect and use Podman if it's available.

License Key¶

A MOJO License Key is required for installation. You can obtain a free 30-day trial license by:

Visiting metify.io
Clicking Download Free Trial in the upper right corner
Completing the registration form

Your license key will be emailed to you after submitting the form. If you need more time to evaluate the product, contact us at support@metify.io, and we'll be happy to extend your trial.

If you've already registered but can't find your license key, simply complete the registration form again, and we'll resend your key.

Installation¶

Now that you have those pre-reqs knocked out, it's time to bring some MOJO into your life!

Step 1: Download and Run the Installer¶

Run the following command to download and start the MOJO installer:

curl -L -s https://download.metify.io/repository/filestore-external/mojo-installer/releases/latest/mojo-install | sudo bash

This command will:

Install prerequisite system packages
Download the MOJO setup package
Guide you through the installation process

The installer automatically installs the following prerequisite packages:

OS	Packages Installed
Debian-based	`bsdextrautils curl jq sudo bash lsof netcat-traditional ldap-utils net-tools`
RedHat-based	`util-linux curl jq sudo bash lsof netcat openldap-clients`

During installation, you'll be prompted to:

Specify an installation directory (default: /opt/mojo)
Accept the MOJO license agreement
Enter your MOJO License Key

Step 2: Configure MOJO¶

The setup process runs automatically during installation. It will guide you through configuring:

Network settings (interface, hostname, IP address)
DHCP server options (if you choose to run the DHCP server)
DNS settings
Active Directory integration (optional)

The setup will also automatically:

Check for port availability (80 and 443)
Generate self-signed SSL certificates
Scale resources based on your system capabilities

If you need to run the setup again or make configuration changes later, you can manually execute:

cd /opt/mojo
sudo ./mojo-setup

Configuration File

The configs/mojo.env file contains your MOJO configuration. You can re-run ./mojo-setup to update this file or edit it directly. Be aware that manual edits will be overwritten the next time ./mojo-setup is run.

Step 3: SSL Certificates¶

MOJO automatically generates self-signed SSL certificates. If you prefer to use your own certificates:

Place your certificate files in the configs/ssl/ directory
Name them cert.crt and cert.key

Running MOJO¶

Starting MOJO for the First Time¶

To start MOJO for the first time, including downloading all necessary container images:

sudo ./mojo-launcher start mojo --update

This may take some time as it downloads all supporting container images. Once complete, you can access MOJO at the hostname you configured.

Regular Startup¶

For subsequent starts (after reboots or stops), use:

sudo ./mojo-launcher start mojo

Accessing the Web Console¶

Once MOJO is running, access the web console at:

https://<your-configured-hostname>

Default login credentials:

Username: admin
Password: admin

Security Recommendation

We strongly recommend changing the default password after your first login to meet your security requirements.

Managing MOJO¶

Updating MOJO¶

To update to a newer version of MOJO:

sudo ./mojo-launcher update mojo

This updates the container images without stopping your running MOJO instance. To apply the updates, restart MOJO:

sudo ./mojo-launcher restart mojo

Note

Updates may take some time to complete as they might include data migration or other platform maintenance tasks.

Stopping MOJO¶

To stop the MOJO platform:

sudo ./mojo-launcher stop mojo

All persistent data required to relaunch MOJO is preserved in the installation directory.

Enable Auto-Start on Boot¶

To configure MOJO to start automatically when your system boots:

sudo ./mojo-launcher enable-autostart

To disable auto-start:

sudo ./mojo-launcher disable-autostart

Loading Data and Resources¶

Loading OS Images¶

To load an OS image bundle into MOJO:

sudo ./mojo-manage --os-image

Follow the prompts to complete the process. You can load OS bundles from:

The Metify repository (downloaded automatically)
A local file on your system

Loading Firmware Bundles¶

To load a firmware bundle:

sudo ./mojo-manage --firmware

Follow the prompts to complete the process.

Viewing Logs¶

To view container logs:

sudo ./mojo-manage --logs

For more detailed log viewing with custom options:

sudo ./mojo-manage --logs --tail 200 app -f

Additional arguments are passed through to the container runtime's compose logs command.

Support¶

If you have any questions or concerns about the MOJO Platform, please contact us at support@metify.io. Our team is here to help!

For additional documentation, visit our support site.