Hosting panels
Hosting panels
Hosting panels connects Max to hosting control panels, today cPanel accounts on shared hosting. You can see each account's sites, PHP versions, certificates, disk space, mailboxes and forwarders, and what needs attention (module hosting).
In the sidebar under Servers & apps → Hosting panels. Needs: nothing. Handles secrets: the module holds each panel's API token.
What you see is Max's own copy. It is read once a day, when you press Refresh, and after every change.
At the top, Needs attention lists the worst first: connections that stopped working, sites on a PHP version past its security support, certificates about to expire or failing AutoSSL, and accounts near their disk limit. Each is marked Urgent or Soon.
Sites
Every site on each account: its domain and kind (main, addon, subdomain, parked), its PHP version, its certificate, and whether AutoSSL renews it. Open a site to see everything about it in one place, including Changes Max made to it.
The Hosting accounts list shows each cPanel account: its plan, and disk space, bandwidth and file count against their limits. Press Refresh on an account to read it again now.
The mailboxes and forwarders on each account, by domain. A mailbox shows space used and quota. If the host has switched mail off on an account, the page says so.
Certificates
Who issued each site's certificate, when it expires, and why AutoSSL failed where it did.
Connections
The panels connected to Max, and whether each still works (working, refused, unreachable, or blocked by the server).
- Click Add a hosting connection.
- Enter a name, the panel's address and port, the cPanel username, and an API token made in cPanel.
- Save. Max reads the account straight away.
On a connection you can:
- change its name, address or port;
- Test it: calls the panel once. This is the only way out of "refused" or "blocked"; Max never retries those by itself;
- paste a new token. Max tests it at once;
- forget it. Max deletes the connection and everything it read through it. Nothing changes at the panel. Remember to revoke the token in cPanel too.
Who can do what
| Permission | Lets you |
|---|---|
hosting:read | See hosting panel connections, the sites, PHP versions, certificates, usage, mailboxes and forwarders they hold, and the changes made to them |
hosting:write | Connect hosting panels and change them: PHP version, certificate check, mailboxes, forwarders, and on a server suspending accounts |
What happens on its own
| Job | When | What it does |
|---|---|---|
check | Every 30 minutes | Checks that each working connection still answers. |
refresh | Every day at 03:30 UTC | Reads every connection in full: sites, PHP, certificates, disk space and mail. |
sweep | Every hour, at quarter past | Deletes any one-time password that waited more than ten minutes to be shown and was never opened. |
Needs
Nothing else needs to be switched on.
What agents can do
Look (read-only, runs straight away)
hosting.overview: what needs attention, worst first.hosting.connections,hosting.accounts: connections and cPanel accounts.hosting.sites,hosting.site: sites, or everything about one site.hosting.mailboxes,hosting.forwarders: mail on an account.hosting.changes: changes Max made, newest first.hosting.refresh: reads a panel again now. Only for a connection that works or was unreachable.
Ask for a connection (asks a person)
hosting.requestConnection: asks a person to connect a panel. An agent can never connect one itself, because the token must be typed by a person, never passed through a chat.