Skip to content
Mini PanelMini Panel

Installation

Requirements

Section titled “Requirements”
  • A VPS running Debian 12/13, Ubuntu 22.04/24.04/26.04, or AlmaLinux, Rocky Linux, CentOS Stream 9/10; x86_64 or arm64 (aarch64) architecture.
  • At least 1 GB RAM.
  • Root access (or sudo).
  • A public IP address; a domain name is optional and can be added later.

Installing

Section titled “Installing”

SSH into the VPS as root, then run:

Terminal window
curl -fsSL https://mpanel.biz/install.sh | sh

The installer will:

  1. Check the operating system and architecture, and stop if they aren’t supported.
  2. Download the mpn program from the latest GitHub release and compare its SHA-256 with the SHA256SUMS file. If they don’t match, it stops and installs nothing.
  3. Install Nginx 1.28.3 (a pinned version from nginx.org) with the pagespeed module. The ModSecurity module, built for this exact Nginx, is installed only when you turn on the web application firewall on the Security tab, because it uses more RAM.
  4. Install the panel as two services, mpn-web (unprivileged) and mpn-root (the privileged helper), with a self-signed TLS certificate so the panel serves HTTPS from the start.
  5. Print instructions and the address to open the panel, in the form https://<your-ip>:2610/setup.

Installation takes a few minutes depending on network speed.

The installer does not install PHP, Node.js or a database. Pick what your websites need on the Services page after signing in: PHP 7.0 to 8.5, Node.js 18 to 24, MariaDB or MySQL, phpMyAdmin.

Options

Section titled “Options”
Variable Meaning
MPN_VERSION Install a fixed release, such as 1.0.0. The default is the latest release.
MPN_PANEL_PORT HTTPS port of the panel. The default is 2610.

Example:

Terminal window
curl -fsSL https://mpanel.biz/install.sh | MPN_VERSION=1.0.0 sh

To read the installer before running it:

Terminal window
curl -fsSLO https://mpanel.biz/install.sh
less install.sh
sh install.sh

AlmaLinux, Rocky Linux and CentOS Stream

Section titled “AlmaLinux, Rocky Linux and CentOS Stream”

On these systems Mini Panel does a few things differently from Debian and Ubuntu:

  • Nginx 1.28.3 comes from the nginx.org repository and is locked with dnf versionlock, so dnf upgrade leaves it alone.
  • PHP 7.4 and newer come from the Remi repository (it needs EPEL, which the installer turns on). PHP 7.0 to 7.3 and the ModSecurity module are built by the project and checked by SHA-256.
  • MariaDB comes from rpm.mariadb.org and MySQL from repo.mysql.com. Version 10 has MySQL 8.4 only, because repo.mysql.com does not publish MySQL 8.0 for it.
  • SELinux stays on. The panel labels the website folders, the logs, the PHP-FPM sockets and its own ports, so there is no need to turn SELinux off.
  • firewalld is turned off. The panel manages the firewall with nftables on the Firewall page.
  • PHP 7.0 to 7.3 on version 10 have no intl extension.

After installing

Section titled “After installing”
  1. Open https://<your-ip>:2610/setup and create the administrator account. See First-run setup.
  2. Go to the Services page to install PHP, Node.js and a database as you need.
  3. Add a website, point its domain at the server’s IP, then turn on SSL.

If your VPS provider has its own firewall, open TCP ports 80 and 443 and the panel port (2610 by default).

Updating

Section titled “Updating”

Run the install command again. It downloads the latest release and replaces the mpn program; websites, databases and the administrator account are kept.

Join our Discord