Skip to content

Install ​

One command ​

Log in to your server over SSH and run:

bash
curl -fsSL https://merppanel.multierp.com/install.sh | sudo bash

The installer downloads the latest version, checks its SHA-256, installs Nginx (or Apache), MariaDB, PHP-FPM and certbot, creates the panel's user, folders and systemd services, opens ports 80, 443 and 8443 if ufw is active, and prints the panel address and the admin password once. It takes 3 to 6 minutes.

Save the password

The admin password is printed only at the end of the install. Copy it before you close the terminal. If you lose it, see Reset a password.

Options ​

Pass options after bash -s --:

bash
curl -fsSL https://merppanel.multierp.com/install.sh | sudo bash -s -- \
  --lang ar --web nginx --admin nasser --email you@example.com
OptionDefaultMeaning
--web nginx|apachenginxThe web server for your sites
--lang ar|en|esenDefault panel language (each user can change theirs)
--admin USERadminName of the first administrator
--port N8443Port of the panel
--email ADDRESSEmail for Let's Encrypt
--license FILEA license file to install
--no-firewallDo not touch ufw

Before you install ​

  1. Pick the right server. Ubuntu 24.04 is best. Run uname -m: x86_64 means amd64, aarch64 means arm64. Both are supported.
  2. Open the ports in your provider's firewall (AWS Security Group, Hetzner Firewall…): 22 (SSH), 80 and 443 (sites and Let's Encrypt) and 8443 (the panel). For email also 25, 465, 587, 993, 995, 143, 110.
  3. Point a domain at the server if you want a clean panel address, such as panel.example.com → an A record to the server IP.

First sign-in ​

  1. Open https://SERVER-IP:8443. The browser warns about the certificate: the panel starts with a self-signed one. Continue.
  2. Sign in with the admin name and the printed password.
  3. Go to My account and turn on two-step sign-in. Keep the recovery codes somewhere safe.
  4. Open SSL certificates → The panel's own domain, enter panel.example.com and press Get certificate. From then on open the panel at https://panel.example.com:8443 with no warning. See SSL.
  5. Create your first site.

Check that both services are running:

bash
systemctl status hostpanel hostagent --no-pager

Reset a password ​

On the server, as root:

bash
sudo -u hostpanel hostpanel set-password --username nasser   # prints a new password
# or, with the command line tool:
sudo merp reset-admin --username nasser            # add --reset-2fa if the phone is lost too

Where things live ​

PathWhat
/opt/hostpanel/bin/The programs (hostpanel, hostagent, merp)
/etc/hostpanel/panel.envPanel settings (port, TLS, language…)
/etc/hostpanel/agent.envAgent settings (web server, sites folder, terminal…)
/var/lib/hostpanel/panel.dbThe panel's database
/srv/sites/DOMAIN/Each site's files (public_html is the web root)
/var/log/hostpanel/sites/Site logs
/var/backups/hostpanel/Local backups

Useful commands:

bash
journalctl -u hostpanel -u hostagent -n 150 --no-pager   # logs
systemctl reload hostpanel                                # reload language files

Next: find your way around.

SetServer Panel documentation