Permissions reference
Permission names double as API token abilities. The owner holds every permission. The role matrix is on Teams, roles and permissions.
| Permission | Grants | Roles (besides owner) |
|---|---|---|
alerting.view |
View alert rules, channels, history; receive in-app notifications | admin, developer, viewer |
alerting.manage |
Manage alert channels and rules | admin |
audit.view |
View the audit log | admin |
builds.view |
View builds, build logs and builders | admin, developer, viewer |
builds.manage |
Cancel builds and manage builders | admin, developer |
config.view |
Config as code: validate, plan, export, read runs, drift and unmanaged resources | admin, developer, viewer |
config.apply |
Create config runs (falak apply, Apply now), cancel them, connect, enable and disable the config source |
admin, developer |
config.approve |
Approve or reject config runs with risky changes; change who may approve and the allowed credentials | admin |
config.destroy |
Config runs with allow_destroy (delete what the file removed, data included) |
admin |
databases.view |
View database containers, databases, users and backups | admin, developer, viewer |
databases.manage |
Create and drop databases and users, manage backup schedules, run backups | admin, developer |
databases.credentials.reveal |
Reveal database user passwords | admin, developer |
databases.restore |
Restore backups, point-in-time restores, export backup keys, turn PITR off | admin |
databases.storage.manage |
Manage backup storage providers and credentials | admin |
deployments.view |
View deployments, their output and releases | admin, developer, viewer |
deployments.create |
Deploy sites; cancel queued, waiting or building deployments | admin, developer |
deployments.rollback |
Roll sites back to an earlier release | admin, developer |
deployments.manage |
Strategy, health checks, retention, push-to-deploy, deploy hooks | admin, developer |
edge.view |
View domains, certificates and routing rules; domain options and DNS checks | admin, developer, viewer |
edge.manage |
Manage domains, certificates, redirects, security rules and load balancers | admin, developer |
edge.dns.manage |
DNS provider credentials (DNS-01) and generated-domain settings | admin |
fleet.agents.manage |
Issue install commands, revoke and upgrade agents | admin |
fleet.commands.view |
View agent command output | admin, developer, viewer |
insights.view |
View insights, issues and scheduled task health | admin, developer, viewer |
insights.manage |
Resolve, assign and comment on issues; configure thresholds and heartbeats | admin, developer |
members.view |
View members and teams | admin, developer, viewer |
members.manage |
Invite, remove and change roles of members | admin |
teams.manage |
Create teams and manage their members | admin |
network.view |
View firewalls, private networks and load balancers | admin, developer, viewer |
network.manage |
Manage firewall rules and private networks | admin, developer |
network.protect |
Block IP addresses and configure SSH auto-ban (Network protection) | admin |
network.ebpf |
Turn the eBPF probe (TCP and DNS insights) on or off on servers | admin |
network.tools |
Run network tools (ping, traceroute, DNS, HTTP, TCP) from servers and containers | admin |
network.capture |
Capture network traffic on servers and containers (pcap downloads may contain sensitive data) | admin |
organization.update |
Rename the organization | admin |
organization.delete |
Delete the organization | (owner only) |
previews.view |
View pull request previews, their URLs and access credentials | admin, developer, viewer |
previews.manage |
Configure previews, approve previews of forks, redeploy and delete previews | admin, developer |
processes.view |
View workers, daemons, scheduled jobs and status | admin, developer, viewer |
processes.manage |
Manage workers, daemons and scheduled jobs; restart processes | admin, developer |
projects.view |
View projects, environments and canvases | admin, developer, viewer |
projects.manage |
Create, rename, delete projects and environments; arrange and create services on the canvas | admin, developer |
providers.view |
View cloud provider credentials and catalogs | admin, developer, viewer |
providers.manage |
Add, rotate and remove cloud provider credentials | admin |
recipes.view |
View recipes and run history | admin, developer, viewer |
recipes.manage |
Create, edit and delete recipes | admin, developer |
recipes.run |
Run recipes (arbitrary scripts, possibly as root) | admin |
recovery.control_plane |
See the control plane’s disaster recovery status and its setup prompt (operator organization only) | admin |
recovery.servers |
Recover a lost server: move its databases, volumes, services and domains to another server | admin |
recovery.view |
View the disaster recovery readiness of projects | admin, developer, viewer |
secrets.view |
View secret names, versions, access log and usage (never values) | admin, developer, viewer |
secrets.manage |
Create secrets, set values, roll back, disable versions and delete secrets | admin, developer |
secrets.reveal |
Reveal values of non-sensitive secrets (API tokens need this ability explicitly) | admin, developer |
secrets.providers.manage |
Add, edit, test and delete external secret providers | admin |
security.view |
View servers’ security baseline reports | admin, developer, viewer |
security.fix |
Run security audits and apply or undo their fixes on servers | admin |
servers.view |
View servers, metrics and provisioning logs | admin, developer, viewer |
servers.create |
Create servers | admin, developer |
servers.manage |
Manage PHP, settings, SSH keys and re-provision servers | admin, developer |
servers.delete |
Delete servers | admin |
ssh_keys.manage |
Add and remove organization SSH keys | admin, developer |
sites.view |
View sites, settings and command history | admin, developer, viewer |
sites.create |
Create sites | admin, developer |
sites.manage |
Change site settings, servers, deploy scripts, Laravel toggles | admin, developer |
sites.delete |
Delete sites | admin |
sites.env.view |
Reveal site environment variables | admin, developer |
sites.env.manage |
Edit site environment variables | admin, developer |
sites.commands.run |
Run commands in a site on its servers | admin, developer |
sites.compose.policy |
Allow privileged Docker Compose files | admin |
source_control.view |
View git connections, repositories and pushes | admin, developer, viewer |
source_control.manage |
Connect and disconnect git providers | admin |
telemetry.view |
View server metrics, logs and traces | admin, developer, viewer |
telemetry.manage |
Configure telemetry endpoints and provision Grafana | admin |
templates.view |
Browse the catalog and the organization’s templates | admin, developer, viewer |
templates.manage |
Import, edit and delete the organization’s templates | admin, developer |
terminal.open |
Open web terminal sessions and consoles | admin |
terminal.attach |
Watch other members’ shared sessions | admin |
terminal.control |
Type into and close sessions opened by others | admin |
terminal.recordings.view |
Replay other members’ recordings | admin |
uptime.view |
View uptime monitors, incidents and status pages | admin, developer, viewer |
uptime.manage |
Create, change, pause and delete uptime monitors | admin, developer |
uptime.publish |
Publish public status pages | admin |
volumes.view |
View volumes, their usage, attachments and backups | admin, developer, viewer |
volumes.manage |
Create, attach, resize, back up, restore, clone, move and delete volumes | admin, developer |
volumes.browse |
Browse and download the files of volumes (audited) | admin |