Skip to content

Troubleshooting ​

First checks ​

bash
systemctl status hostpanel hostagent --no-pager
journalctl -u hostpanel -u hostagent -n 150 --no-pager

If something is broken after a manual change, Settings → Updates → Repair installs the current version again and puts files and services back. See Repair.

The panel ​

ProblemWhat to do
The page does not openCheck port 8443 is open in your provider's firewall and that hostpanel is running.
Certificate warning in the browserNormal with the self-signed certificate. Give the panel a domain and a real certificate: SSL.
"The agent is not running, so the panel cannot change anything"sudo systemctl restart hostagent, then look at journalctl -u hostagent.
"The form expired or came from another site"Reload the page and try again. Sign out and in if it repeats.
"Too many failed attempts"Wait for the time shown, or sign in from an admin address.
Forgot the passwordsudo merp reset-admin --username NAME on the server.
Lost the 2FA phoneUse a recovery code, or sudo merp reset-2fa NAME.
Locked out by the firewall or a country ruleFrom the provider's console: sudo /opt/hostpanel/bin/hostagent firewall-reset
"Safe Mode is on"An admin ends it in Server protection, or sudo /opt/hostpanel/bin/hostagent safe-mode off.
"Your role does not allow this"Ask an admin to change your role or give you the site.

Sites ​

ProblemWhat to do
DNS badge: "No DNS record" or "DNS points elsewhere"Add or fix the A record at your DNS provider to the server IP.
502 Bad Gateway on an app siteNothing listens on the app port. Start your app, or change the site type.
"This site uses PHP X, which is not installed"Install that version from the App Store, or pick another on the site page.
403 / blank page on a React/Vue siteThe site folder must point to the build (public_html/dist) and contain index.html.
404 on refresh in a single-page appUse the React / Vue app type, not Static files.
"The folder … does not exist in the site yet"Create it in the file manager, then set the site folder.
Upload too bigRaise max upload on the site page and, if needed, the PHP version's upload limit. The smaller wins.
WordPress cannot update pluginsCheck Server protection → Outgoing connections is not set to Only the list for that site.
A plugin needs execTick Allow PHP to run programs on the site page (admins).

SSL ​

ProblemWhat to do
"Set the Let's Encrypt email first"Enter it on the SSL page.
Certificate request failsThe domain must point to this server and port 80 must be open. Wait a few minutes after changing DNS.
Too many redirects behind CloudflareCloudflare SSL mode must be Full (strict). See Cloudflare.
Error 526 behind CloudflareThe site needs a valid certificate (Let's Encrypt or an Origin certificate).
An extra domain is "Not in certificate"Fix its DNS, then press Update certificate.

Web server and databases ​

ProblemWhat to do
"The web server rejected the change, so nothing was changed"Your edit has an error; the message shows the line. The old config is still live.
Turning on the WAF fails with "unicode map file"Fixed in 1.4.4. Update the panel.
A rule of the WAF blocks normal useTurn that rule off in Traffic, or put the WAF back on Watch only.
"The database server is not running"Databases → Service → Start, and read its log.
"MariaDB/MySQL is not installed"Install it from the App Store.
Database connection refused in your appUse host localhost, the database's own user and its password. Reset the password if lost.

Email ​

ProblemWhat to do
Mail to Gmail/Outlook never arrivesOutgoing port 25 is probably blocked. Ask your provider or use an SMTP relay.
Mail lands in spamAdd all DNS records (SPF, DKIM, DMARC) and set reverse DNS (PTR) to the mail host name.
Mail apps warn about the certificateGet a certificate for the mail host name on the Email page.

Get help ​

Send a screenshot of the page and the output of:

bash
journalctl -u hostpanel -u hostagent -n 150 --no-pager

For the firewall add sudo nft list ruleset | head -80.

SetServer Panel documentation