Install
One command
Log in to your server over SSH and run:
bash
curl -fsSL https://merppanel.multierp.com/install.sh | sudo bashThe 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| Option | Default | Meaning |
|---|---|---|
--web nginx|apache | nginx | The web server for your sites |
--lang ar|en|es | en | Default panel language (each user can change theirs) |
--admin USER | admin | Name of the first administrator |
--port N | 8443 | Port of the panel |
--email ADDRESS | Email for Let's Encrypt | |
--license FILE | A license file to install | |
--no-firewall | Do not touch ufw |
Before you install
- Pick the right server. Ubuntu 24.04 is best. Run
uname -m:x86_64means amd64,aarch64means arm64. Both are supported. - Open the ports in your provider's firewall (AWS Security Group, Hetzner Firewall…):
22(SSH),80and443(sites and Let's Encrypt) and8443(the panel). For email also25, 465, 587, 993, 995, 143, 110. - 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
- Open
https://SERVER-IP:8443. The browser warns about the certificate: the panel starts with a self-signed one. Continue. - Sign in with the admin name and the printed password.
- Go to My account and turn on two-step sign-in. Keep the recovery codes somewhere safe.
- Open SSL certificates → The panel's own domain, enter
panel.example.comand press Get certificate. From then on open the panel athttps://panel.example.com:8443with no warning. See SSL. - Create your first site.
Check that both services are running:
bash
systemctl status hostpanel hostagent --no-pagerReset 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 tooWhere things live
| Path | What |
|---|---|
/opt/hostpanel/bin/ | The programs (hostpanel, hostagent, merp) |
/etc/hostpanel/panel.env | Panel settings (port, TLS, language…) |
/etc/hostpanel/agent.env | Agent settings (web server, sites folder, terminal…) |
/var/lib/hostpanel/panel.db | The 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 filesNext: find your way around.