Security

Users and roles

Invite people to the panel, give them one of the built-in roles, and see exactly which permissions each role grants.

Last updated

Everyone who signs in to the panel has an account with one role. A role is a fixed set of permissions, and the panel checks permissions, never role names, in its service layer, so the same rules apply in the browser, the API, the CLI and the AI assistant. Every denial is recorded in the audit log as authz.denied.

Users

Users & Access > Users lists everyone who can sign in, with their role, status and last sign-in. Search by name or email, and filter by role or by active and inactive accounts. Viewing users needs users.read; inviting and changing them needs users.manage.

Invite a user

Click Invite a user and enter their name, email and role. The panel creates an invite link that works once and expires after 72 hours; they choose their own password with it. When panel email is set up, the link is emailed to them; otherwise send it yourself over a channel you trust. The link is not shown again.

Change a user

Click a user to open Edit:

ActionEffect
NameChanges their display name
RoleChanges their role and signs them out everywhere. You cannot change your own role.
Active (can sign in)Unticking it deactivates the account and ends its sessions. You cannot deactivate yourself.
Create password reset linkA one-time link that expires after 2 hours, emailed when panel email is set up
Turn off two-factor sign-inFor someone who lost their authenticator app and recovery codes. They are signed out everywhere.

Staff accounts are deactivated, not deleted: an inactive account cannot sign in. Hosting customers' accounts are managed from their page under Hosting > Customers instead.

Rules that protect accounts

  • You can only give roles at or below your own, and only manage users whose role is not above yours. Admins therefore cannot give the owner role or change owners.
  • The panel must keep at least one active owner: demoting or deactivating the last one fails with LAST_OWNER.
  • A password must have at least 12 characters.

Built-in roles

Users & Access > Roles shows the built-in roles and the permission matrix. Custom roles are not available yet.

The Roles page: cards for the Owner, Admin, Developer, Viewer and Customer roles with their user and permission counts, above the permission matrixThe Roles page: cards for the Owner, Admin, Developer, Viewer and Customer roles with their user and permission counts, above the permission matrix
RoleFor
OwnerFull control of the panel, including other owners and the server terminal
AdminManaging servers, users (except owners) and settings. Everything an owner has except the server terminal.
DeveloperViewing servers, websites, DNS zones, email, apps, containers and databases; deploying and restarting apps; starting, stopping and restarting containers; backing up; running cron jobs; routine operations such as service restarts; working on website files; and asking the AI assistant
ViewerRead-only access to servers, websites, DNS zones, email, apps, containers, databases, backups, cron jobs and jobs, and the AI assistant
CustomerA hosting customer, who manages only the websites, apps, databases, backups and cron jobs of their own account, within their plan

The Customer role is never given from the Users page. It comes with creating a customer under Hosting > Customers, and its permissions only ever apply inside that customer's account. See Hosting and billing.

Owner-only

servers.terminal, a root shell in the browser, belongs to owners alone. It is not given to admins, and never through an API token, a plugin or the AI assistant. See Terminal.

Permissions

Permissions are named area.action. The tables below list every permission and the built-in roles that have it.

Panel and people

PermissionAllowsOwnerAdminDeveloperViewerCustomer
dashboard.viewView the dashboard✓✓✓✓
users.readView users and their roles✓✓
users.manageInvite, update, deactivate users and issue password reset links✓✓
roles.readView roles and their permissions✓✓
audit.readView the audit log✓✓
settings.manageChange panel settings✓✓
jobs.readView jobs and their logs✓✓✓✓✓
jobs.cancelCancel queued jobs✓✓
assistant.useAsk the AI assistant, which reads what you are allowed to see and proposes changes for you to approve✓✓✓✓
plugins.manageInstall, approve, turn off and remove plugins, and see the events sent to them✓✓

Servers and monitoring

PermissionAllowsOwnerAdminDeveloperViewerCustomer
servers.readView servers, their status and metrics✓✓✓✓
servers.manageAdd, rename and remove servers, manage server groups, update agents and issue enrollment tokens✓✓
servers.servicesCheck, start, stop and restart services and read their logs✓✓✓
servers.processesList running processes on a server✓✓✓
servers.rebootReboot a server✓✓
servers.signalStop or kill processes on a server✓✓
servers.bulkRun an operation on several servers at once (each server still needs the permission for the operation itself)✓✓
servers.terminalOpen a root terminal on a server from the browser (owners only; every session is in the audit log)✓
servers.logsRead system, kernel, sign-in and cron logs on servers✓✓
alerts.readView alerts and alert rules✓✓✓✓
alerts.acknowledgeAcknowledge firing alerts✓✓✓
alerts.manageCreate, change and delete alert rules✓✓
security.readView firewall rules, SSH settings, Fail2ban and update status of servers✓✓
security.manageChange firewall rules, SSH settings, SSH keys, Fail2ban and automatic updates, and install security updates✓✓

Websites, apps and data

PermissionAllowsOwnerAdminDeveloperViewerCustomer
websites.readView websites, domains and SSL certificates✓✓✓✓✓
websites.manageCreate, change and delete websites, their domains and SSL certificates, and install the web stack✓✓✓
websites.logsRead website access and error logs✓✓✓✓
files.readBrowse and download website files✓✓✓✓
files.writeUpload, edit, rename and delete website files✓✓✓✓
applications.readView applications, their deployments and process state✓✓✓✓✓
applications.manageCreate, change and delete applications, and view and change their environment variables✓✓✓
applications.deployDeploy, roll back, start, stop and restart applications✓✓✓✓
applications.logsRead application output and error logs✓✓✓✓
databases.readView databases and database users✓✓✓✓✓
databases.manageCreate and delete databases and database users, change access and view passwords✓✓✓
containers.readView Docker, containers and images on servers✓✓✓✓
containers.operateStart, stop and restart containers✓✓✓
containers.logsRead the output of containers✓✓✓
containers.manageInstall Docker, deploy, change and remove containers, pull and remove images, and view container environment variables✓✓
dns.readView DNS zones and their records✓✓✓✓
dns.manageSet up DNS servers, and create, change and delete DNS zones and records✓✓
mail.readView email domains, mailboxes and forwarders✓✓✓✓
mail.manageSet up mail servers, and create, change and delete email domains, mailboxes and forwarders✓✓

Backups and automation

PermissionAllowsOwnerAdminDeveloperViewerCustomer
backups.readView backups, backup schedules and restores✓✓✓✓✓
backups.createBack up websites, apps and databases now✓✓✓✓
backups.manageRestore, download and delete backups, and manage backup schedules✓✓✓
cron.readView cron jobs and their run history✓✓✓✓✓
cron.runRun a cron job now✓✓✓✓
cron.manageCreate, change and delete cron jobs✓✓✓
webhooks.manageCreate, change and delete webhooks and see their deliveries✓✓

Hosting and billing

PermissionAllowsOwnerAdminDeveloperViewerCustomer
customers.readView customers, their hosting plans and what they use✓✓
customers.manageCreate customers, change their plan, suspend, unsuspend and remove them, and move websites, apps and databases to them✓✓
plans.manageCreate, change and delete hosting plans✓✓
billing.manageCreate and revoke the API keys billing systems use✓✓

API tokens

API tokens act as the person who created them, narrowed to the scopes chosen for the token. A token can never do more than its owner, and narrowing someone's role narrows their tokens too. See API tokens.