Repair Tool
The Repair Tool is Panelica's "fix common problems" button: it scans the server for the faults that usually take a panel or a site down, services that stopped, a broken config, a full disk, wrong file ownership, and offers a safe one-click fix for each. Every fix previews what it will do, asks for confirmation, and is built to be idempotent; the config regeneration additionally rolls back per domain if anything fails.
Repair Toolhttps://YOUR-SERVER-IP:8443/repair (ROOT only)What it checks
On open, the tool scans the server and lists findings worst-first, each with a severity (ok, info, warning, critical), what it found, and a Fix button where a repair is available. The checks cover:
- Services: every core service (backend, external API, the two nginx instances, Apache, PostgreSQL, MySQL, Redis, BIND, the FTP server, fail2ban). A stopped-but-enabled service is critical and fixable; a service in a boot transition is reported calmly as info, not a false alarm.
- Sockets: the three critical Unix sockets (Redis, MySQL, PostgreSQL) exist on disk; a missing socket means the service crashed.
- Configs: nginx, Apache and BIND configs pass their own validators (
nginx -t,httpd -t,named-checkconf); the customer nginx config is regenerable if broken. - Disk: the root and
/opt/panelicafilesystems against 85% (warning) and 95% (critical) thresholds. - Home permissions: each customer's home directory is owned by their own account, the wrong-ownership fault that mysteriously breaks a site.
The fixes, and why they are safe
Repairs are never automatic; you press Fix, see a preview of exactly what will happen, and confirm.
| Fix | What it does, safely |
|---|---|
| Restart service | Restarts only a stopped service (a healthy one is a no-op), validates the unit name, and verifies the service is actually running afterward, not just that the command returned |
| Clean up disk | Deletes only from an allow-list (old temp, trash, expired cache, and rotated, never live, logs); it never walks databases, backups, quarantine or user data, and re-checks each file is a real file right before deleting |
| Regenerate config | Rebuilds the customer nginx vhosts from the database using the same backup-test-rollback path every domain operation uses, so a broken domain can never take the others down and a bad config never loads |
| Reset permissions | Restores a customer's home to Panelica's ownership model (not a blind recursive chown), fixing root-owned files under public_html while preserving the special log and session groups; deletes nothing |
| Fix common problems | Re-runs every idempotent startup self-heal on demand (over twenty of them), each guarded and safe to repeat |
Access
Strictly ROOT, at both the route and the backend, with every applied fix audited. See roles and permissions. When the panel backend itself is down and you cannot reach this page, the same repairs are available from the rescue console on port 8444.