Mutire Platform is the on-premises Mutire Compute control plane. On a single supported host it runs the console, API, and the default Mutire Virtual Environment (MVE) hypervisor together. Treat the result like a private cloud region, not only a hypervisor panel.
Supported base operating systems are Debian 12 (Bookworm) and Ubuntu 24.04 LTS (Noble). Supported CPU architectures are amd64 (x86_64) and arm64 (aarch64). The customer install script auto-detects OS and architecture, then configures the matching apt suite (bookworm or noble). Other distributions are not supported for this install path.
You need a Mutire Platform license key (MP-…). The installer activates the license, configures the packages.mutire.com feed, installs the mutire-platform package, and starts services. Finish networking, licensing, and a pilot instance before inviting application teams.
Supported operating systems
Debian 12 (Bookworm)
fresh minimal install on amd64 or arm64. Apply updates with apt before you run the Mutire installer.
Ubuntu 24.04 LTS (Noble)
fresh server install on amd64 or arm64. Apply updates with apt before you run the Mutire installer.
Architecture
amd64 (x86_64) and arm64 (aarch64) are both supported. The installer selects the matching .deb and QEMU packages automatically.
Not supported
older Debian or Ubuntu releases, non-Debian derivatives, and CPU architectures other than amd64 or arm64.
Host requirements
Base OS
Debian 12 (Bookworm) or Ubuntu 24.04 LTS (Noble) on amd64 or arm64. Fresh minimal or server install is recommended.
MVE support
virtualization enabled in firmware and /dev/kvm available (bare metal or nested virt).
Access
root (or sudo) on the host, plus outbound HTTPS to packages.mutire.com and the Mutire license API during install and updates.
License
a Mutire Platform key from Mutire Cloud → Platform licenses so repo access and marketplace downloads unlock.
Storage and network
disk space for templates and volumes, and a planned uplink. The installer leaves the uplink IP alone and creates local bridges (vmbr0 / vmbr1) for guest traffic.
Prepare the host (Debian or Ubuntu)
Install Debian 12 or Ubuntu 24.04 LTS.
Choose amd64 or arm64 to match your hardware. Complete first-boot networking and confirm SSH as root or with sudo.
Update the OS. On either distribution run
sudo apt-get update && sudo apt-get upgrade -y, then reboot if the kernel or firmware changed.
Confirm MVE readiness.
Check that virtualization is enabled and that /dev/kvm exists before you install the control plane.
Collect your license key (MP-…) from Mutire Cloud → Platform licenses.
Keep it ready for the install command.
Install Mutire Platform (control plane)
As root on the prepared Debian 12 or Ubuntu 24.04 host, run: curl -fsSL https://packages.mutire.com/onprem/install.sh | sudo bash -s -- --license 'MP-xxxx'. Replace MP-xxxx with your license key.
Wait for the installer to finish.
It detects Debian vs Ubuntu and amd64 vs arm64, writes the apt source, installs mutire-platform, configures PostgreSQL, bridges, and starts mutire-net, mutire-agent, mutire-api, and mutire-web.
Open the console at http://YOUR_SERVER_IP/ (or https if you already configured TLS). Sign in with the admin credentials printed by the installer (default first install uses admin@mutire.local unless you changed it).
Confirm the license.
Open Licenses and updates. Activate or sync the key so packages access, updates, and marketplace downloads stay unlocked.
Configure the region.
Create a VPC and subnets, public IP pools if needed, firewall policies, login profiles, and network profiles before production launches.
Download marketplace images.
Open Marketplace, select only the images you need, and download them into local template storage.
Launch a pilot instance on the default MVE host, attach networking, and verify console health on Overview.
Optional later upgrades
sudo apt-get update && sudo apt-get install --only-upgrade mutire-platform, then restart mutire-agent mutire-api mutire-web when required.
What the install sets up
nginx
public console and API on ports 80 and 443.
mutire-web and mutire-api
console and control plane on localhost.
mutire-agent
default MVE hypervisor on this host.
Networking helpers
local bridges and NAT for guest traffic, with uplink IP left unchanged.
PostgreSQL
local database used by the control plane.
Optional: add another hypervisor
Prepare another host on the same supported matrix
Debian 12 or Ubuntu 24.04 LTS, amd64 or arm64, with MVE available.
Install the hypervisor agent only
curl -fsSL https://packages.mutire.com/onprem/install-hypervisor.sh | sudo bash -s -- --yes --license 'MP-xxxx'. The script auto-detects OS and architecture the same way.
Join the cluster.
In the console open Hypervisors → Add, create a join token, then run the printed mci node join command on that host.
Upgrade later
Package upgrade
sudo apt-get update && sudo apt-get install --only-upgrade mutire-platform.
Console path
Licenses and updates → Check for updates.
Running instances
normal upgrades keep guests up. Stop instances before upgrading hypervisor/QEMU packages when required.