Mojo Installation Guide
System Requirements
Mojo works best on a fresh Linux installation. The platform has been thoroughly tested on the following distributions:
- Debian-based: Ubuntu 22.04.03, Debian 12 (Bookworm), Linux Mint
- Redhat-based: RHEL, 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 22.04.03 or Debian 12 for the best experience.
Hardware Requirements:
- Memory: Minimum 8GB RAM (recommended)
- Disk Space: At least 40GB free space
- Network: A network interface with internet access
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 support page.
Prerequisites
1. Docker Installation
Docker is required to run the Mojo Platform. If you don’t have Docker installed, the Mojo installer will offer to install it 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 |
2. 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 or through our support chat in Discourse, 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.
Install MOJO
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:
-
Debian-based systems:
apt install -y bsdextrautils curl jq sudo bash lsof netcat-traditional ldap-utils -
Redhat-based systems:
dnf install -y util-linux curl jq sudo bash lsof netcat openldap-clients
-
Download the Mojo setup package
-
Guide you through the installation process
During installation, you’ll be prompted to:
-
Specify an installation directory (default:
/opt/mojo) -
Accept the Mojo license agreement
-
Enter your Mojo License Key
This will install some prerequisite system packages:
| OS | Command |
|---|---|
| Debian-based | apt install -y bsdextrautils curl jq sudo bash lsof |
| Redhat-based | dnf install -y util-linux curl jq sudo bash lsof |
It will also download the mojo-setup.tgz package which brings us to:
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
To skip the connection check during setup, use:
sudo ./mojo-setup --skip-connection-check
Basic configuration is done automatically during setup. The configs/mojo.env file contains the most recent Mojo configuration. You can choose to re-run the ./mojo-setup script to update this file or edit it directly.
Please be aware that any edits done manually to the file will be overwritten the next time ./mojo-setup is run and may not be compatible with the future releases of Mojo.
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.crtandcert.key
Running Mojo
Starting Mojo for the First Time
To start Mojo for the first time, including downloading all necessary Docker images:
sudo ./mojo-launcher start mojo --update
This may take some time as it downloads all supporting Docker 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
Important: 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 Docker 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.
Loading Data and Resources
Loading OS Images
To load an OS image bundle into Mojo:
sudo ./mojo-manage --osimage
Follow the prompts to complete the process.
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 # Default logs
sudo ./mojo-manage --logs --tail 200 app -f # Custom log view
Support
If you have any questions, comments, 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.