View .md

Permission nodes

Every FeatherPanel admin permission node (140) and every subuser permission for game servers (50) and WebSpaces (39), generated from the source.

Last synced from FeatherPanel 15b94e9 on .

On this page

How permissions work

  • Roles hold admin permission nodes. Every user has exactly one role. A fresh install creates four roles: User, Support, Moderator and Administrator. Administrator gets admin.root.
  • The first account registered on a new panel is put in the Administrator role.
  • Checks are exact string matches. There are no wildcards: admin.root is the only node that grants everything.
  • Role permissions are cached (Redis, or files when Redis is down) and the cache is invalidated whenever a role's permissions change.
  • Admins with admin.root or one of admin.servers.view, admin.servers.edit or admin.servers.delete can open any game server from the client area.
  • Subuser permissions are separate. They are granted per server (or per WebSpace) by its owner and only apply there.
  • API keys inherit the permissions of the user who created them. See API authentication.
  • Plugins can declare their own nodes; see Routes and permissions.

Admin permission nodes

Source of truth: permission_nodes.fpperm, from which backend/app/Permissions.php and the frontend permission list are generated.

Admin Root

NodeConstantGrants
admin.rootADMIN_ROOTFull access to everything

Admin Dashboard View

NodeConstantGrants
admin.dashboard.viewADMIN_DASHBOARD_VIEWAccess to view the admin dashboard

Admin Users

NodeConstantGrants
admin.users.listADMIN_USERS_VIEWView the users
admin.users.createADMIN_USERS_CREATECreate new users
admin.users.editADMIN_USERS_EDITEdit existing users
admin.users.deleteADMIN_USERS_DELETEDelete users
admin.users.impersonateADMIN_USERS_IMPERSONATEView the panel as another user (audit logged)

Admin Banned IPs

NodeConstantGrants
admin.blocked_ips.viewADMIN_BLOCKED_IPS_VIEWView banned panel IPs
admin.blocked_ips.createADMIN_BLOCKED_IPS_CREATEBan IPs from panel registration
admin.blocked_ips.deleteADMIN_BLOCKED_IPS_DELETERemove panel IP bans

Admin Locations

NodeConstantGrants
admin.locations.viewADMIN_LOCATIONS_VIEWView locations
admin.locations.createADMIN_LOCATIONS_CREATECreate new locations
admin.locations.editADMIN_LOCATIONS_EDITEdit existing locations
admin.locations.deleteADMIN_LOCATIONS_DELETEDelete locations

Admin Realms

NodeConstantGrants
admin.realms.viewADMIN_REALMS_VIEWView realms
admin.realms.createADMIN_REALMS_CREATECreate new realms
admin.realms.editADMIN_REALMS_EDITEdit existing realms
admin.realms.deleteADMIN_REALMS_DELETEDelete realms

Admin Spells

NodeConstantGrants
admin.spells.viewADMIN_SPELLS_VIEWView spells
admin.spells.createADMIN_SPELLS_CREATECreate new spells
admin.spells.editADMIN_SPELLS_EDITEdit existing spells
admin.spells.deleteADMIN_SPELLS_DELETEDelete spells

Admin Nodes

NodeConstantGrants
admin.nodes.viewADMIN_NODES_VIEWView nodes
admin.nodes.createADMIN_NODES_CREATECreate new nodes
admin.nodes.editADMIN_NODES_EDITEdit existing nodes
admin.nodes.deleteADMIN_NODES_DELETEDelete nodes

Admin Roles

NodeConstantGrants
admin.roles.viewADMIN_ROLES_VIEWView roles
admin.roles.createADMIN_ROLES_CREATECreate new roles
admin.roles.editADMIN_ROLES_EDITEdit existing roles
admin.roles.deleteADMIN_ROLES_DELETEDelete roles

Admin Databases

NodeConstantGrants
admin.databases.viewADMIN_DATABASES_VIEWView databases
admin.databases.createADMIN_DATABASES_CREATECreate new databases
admin.databases.editADMIN_DATABASES_EDITEdit existing databases
admin.databases.deleteADMIN_DATABASES_DELETEDelete databases
admin.databases.manageADMIN_DATABASES_MANAGEManage database

Admin Role Permissions

NodeConstantGrants
admin.roles.permissions.viewADMIN_ROLES_PERMISSIONS_VIEWView role permissions
admin.roles.permissions.createADMIN_ROLES_PERMISSIONS_CREATECreate new role permissions
admin.roles.permissions.editADMIN_ROLES_PERMISSIONS_EDITEdit existing role permissions
admin.roles.permissions.deleteADMIN_ROLES_PERMISSIONS_DELETEDelete role permissions

Admin Settings

NodeConstantGrants
admin.settings.viewADMIN_SETTINGS_VIEWView settings
admin.settings.editADMIN_SETTINGS_EDITEdit and manage settings

Admin Storage Sense

NodeConstantGrants
admin.storage_sense.viewADMIN_STORAGE_SENSE_VIEWView Storage Sense insights and cleanup candidates
admin.storage_sense.manageADMIN_STORAGE_SENSE_MANAGERun Storage Sense cleanup actions

Admin Allocations

NodeConstantGrants
admin.allocations.viewADMIN_ALLOCATIONS_VIEWView allocations
admin.allocations.createADMIN_ALLOCATIONS_CREATECreate new allocations
admin.allocations.editADMIN_ALLOCATIONS_EDITEdit existing allocations
admin.allocations.deleteADMIN_ALLOCATIONS_DELETEDelete allocations

Admin Servers

NodeConstantGrants
admin.servers.viewADMIN_SERVERS_VIEWView all servers
admin.servers.createADMIN_SERVERS_CREATECreate new servers
admin.servers.editADMIN_SERVERS_EDITEdit existing servers
admin.servers.deleteADMIN_SERVERS_DELETEDelete servers
admin.servers.installADMIN_SERVERS_INSTALLInstall servers
admin.servers.reinstallADMIN_SERVERS_REINSTALLReinstall servers
admin.servers.suspendADMIN_SERVERS_SUSPENDSuspend servers
admin.servers.unsuspendADMIN_SERVERS_UNSUSPENDUnsuspend servers

Admin Email Templates

NodeConstantGrants
admin.email.templates.viewADMIN_TEMPLATE_EMAIL_VIEWView email templates
admin.email.templates.createADMIN_TEMPLATE_EMAIL_CREATECreate new email templates
admin.email.templates.editADMIN_TEMPLATE_EMAIL_EDITEdit existing email templates
admin.email.templates.deleteADMIN_TEMPLATE_EMAIL_DELETEDelete email templates

Admin Images

NodeConstantGrants
admin.images.viewADMIN_IMAGES_VIEWView images
admin.images.createADMIN_IMAGES_CREATECreate new images
admin.images.editADMIN_IMAGES_EDITEdit existing images
admin.images.deleteADMIN_IMAGES_DELETEDelete images
NodeConstantGrants
admin.redirect_links.viewADMIN_REDIRECT_LINKS_VIEWView redirect links
admin.redirect_links.createADMIN_REDIRECT_LINKS_CREATECreate new redirect links
admin.redirect_links.editADMIN_REDIRECT_LINKS_EDITEdit existing redirect links
admin.redirect_links.deleteADMIN_REDIRECT_LINKS_DELETEDelete redirect links

Admin Plugins

NodeConstantGrants
admin.plugins.viewADMIN_PLUGINS_VIEWView plugins
admin.plugins.installADMIN_PLUGINS_INSTALLInstall plugins
admin.plugins.uninstallADMIN_PLUGINS_UNINSTALLUninstall plugins
admin.plugins.manageADMIN_PLUGINS_MANAGEManage plugins

Admin Statistics

NodeConstantGrants
admin.statistics.viewADMIN_STATISTICS_VIEWView statistics

Admin Subdomains

NodeConstantGrants
admin.subdomains.viewADMIN_SUBDOMAINS_VIEWView subdomains
admin.subdomains.createADMIN_SUBDOMAINS_CREATECreate new subdomains
admin.subdomains.editADMIN_SUBDOMAINS_EDITEdit subdomains
admin.subdomains.deleteADMIN_SUBDOMAINS_DELETEDelete subdomains

Admin FeatherZeroTrust

NodeConstantGrants
admin.featherzerotrust.viewADMIN_FEATHERZEROTRUST_VIEWView FeatherZeroTrust scanner
admin.featherzerotrust.scanADMIN_FEATHERZEROTRUST_SCANRun scans with FeatherZeroTrust
admin.featherzerotrust.configureADMIN_FEATHERZEROTRUST_CONFIGUREConfigure FeatherZeroTrust settings
admin.featherzerotrust.manageADMIN_FEATHERZEROTRUST_MANAGEManage FeatherZeroTrust

Admin Notifications

NodeConstantGrants
admin.notifications.viewADMIN_NOTIFICATIONS_VIEWView notifications
admin.notifications.createADMIN_NOTIFICATIONS_CREATECreate new notifications
admin.notifications.editADMIN_NOTIFICATIONS_EDITEdit existing notifications
admin.notifications.deleteADMIN_NOTIFICATIONS_DELETEDelete notifications

Admin Database Snapshots

NodeConstantGrants
admin.backups.viewADMIN_BACKUPS_VIEWView database snapshots
admin.backups.createADMIN_BACKUPS_CREATECreate database snapshots
admin.backups.deleteADMIN_BACKUPS_DELETEDelete database snapshots
admin.backups.restoreADMIN_BACKUPS_RESTORERestore database from snapshot
admin.backups.downloadADMIN_BACKUPS_DOWNLOADDownload database snapshots

Admin Backup Schedules

NodeConstantGrants
admin.backup_schedules.viewADMIN_BACKUP_SCHEDULES_VIEWView server backup schedules
admin.backup_schedules.createADMIN_BACKUP_SCHEDULES_CREATECreate server backup schedules
admin.backup_schedules.editADMIN_BACKUP_SCHEDULES_EDITEdit server backup schedules
admin.backup_schedules.deleteADMIN_BACKUP_SCHEDULES_DELETEDelete server backup schedules
admin.backup_schedules.runADMIN_BACKUP_SCHEDULES_RUNManually run server backup schedules

Admin Knowledgebase Categories

NodeConstantGrants
admin.knowledgebase.categories.viewADMIN_KNOWLEDGEBASE_CATEGORIES_VIEWView knowledgebase categories
admin.knowledgebase.categories.createADMIN_KNOWLEDGEBASE_CATEGORIES_CREATECreate new knowledgebase categories
admin.knowledgebase.categories.editADMIN_KNOWLEDGEBASE_CATEGORIES_EDITEdit existing knowledgebase categories
admin.knowledgebase.categories.deleteADMIN_KNOWLEDGEBASE_CATEGORIES_DELETEDelete knowledgebase categories

Admin Knowledgebase Articles

NodeConstantGrants
admin.knowledgebase.articles.viewADMIN_KNOWLEDGEBASE_ARTICLES_VIEWView knowledgebase articles
admin.knowledgebase.articles.createADMIN_KNOWLEDGEBASE_ARTICLES_CREATECreate new knowledgebase articles
admin.knowledgebase.articles.editADMIN_KNOWLEDGEBASE_ARTICLES_EDITEdit existing knowledgebase articles
admin.knowledgebase.articles.deleteADMIN_KNOWLEDGEBASE_ARTICLES_DELETEDelete knowledgebase articles

Admin API

NodeConstantGrants
admin.api.bypass_restrictionsADMIN_API_BYPASS_RESTRICTIONSBypass API rate limits and restrictions

User API

NodeConstantGrants
user.api_keys.createUSER_API_KEYS_CREATECreate personal API keys even when user API key creation is disabled panel-wide

User Servers

NodeConstantGrants
user.servers.bypass_subdomain_requirementUSER_SERVERS_BYPASS_SUBDOMAIN_REQUIREMENTUse servers without a panel subdomain when subdomain is required panel-wide

Admin Tickets

NodeConstantGrants
admin.tickets.viewADMIN_TICKETS_VIEWView support tickets
admin.tickets.createADMIN_TICKETS_CREATECreate support tickets
admin.tickets.editADMIN_TICKETS_EDITEdit support tickets
admin.tickets.deleteADMIN_TICKETS_DELETEDelete support tickets
admin.tickets.manageADMIN_TICKETS_MANAGEManage all aspects of support tickets

Admin Ticket Categories

NodeConstantGrants
admin.ticket_categories.viewADMIN_TICKET_CATEGORIES_VIEWView ticket categories
admin.ticket_categories.createADMIN_TICKET_CATEGORIES_CREATECreate ticket categories
admin.ticket_categories.editADMIN_TICKET_CATEGORIES_EDITEdit ticket categories
admin.ticket_categories.deleteADMIN_TICKET_CATEGORIES_DELETEDelete ticket categories

Admin Ticket Priorities

NodeConstantGrants
admin.ticket_priorities.viewADMIN_TICKET_PRIORITIES_VIEWView ticket priorities
admin.ticket_priorities.createADMIN_TICKET_PRIORITIES_CREATECreate ticket priorities
admin.ticket_priorities.editADMIN_TICKET_PRIORITIES_EDITEdit ticket priorities
admin.ticket_priorities.deleteADMIN_TICKET_PRIORITIES_DELETEDelete ticket priorities

Admin Ticket Statuses

NodeConstantGrants
admin.ticket_statuses.viewADMIN_TICKET_STATUSES_VIEWView ticket statuses
admin.ticket_statuses.createADMIN_TICKET_STATUSES_CREATECreate ticket statuses
admin.ticket_statuses.editADMIN_TICKET_STATUSES_EDITEdit ticket statuses
admin.ticket_statuses.deleteADMIN_TICKET_STATUSES_DELETEDelete ticket statuses

Admin Ticket Attachments

NodeConstantGrants
admin.ticket_attachments.viewADMIN_TICKET_ATTACHMENTS_VIEWView ticket attachments
admin.ticket_attachments.manageADMIN_TICKET_ATTACHMENTS_MANAGEManage ticket attachments

Admin Ticket Messages

NodeConstantGrants
admin.ticket_messages.viewADMIN_TICKET_MESSAGES_VIEWView ticket messages
admin.ticket_messages.manageADMIN_TICKET_MESSAGES_MANAGEManage ticket messages

Admin VM Instances

NodeConstantGrants
admin.vm_instances.viewADMIN_VM_INSTANCES_VIEWView VM instances
admin.vm_instances.editADMIN_VM_INSTANCES_EDITEdit existing VM instances
admin.vm_instances.deleteADMIN_VM_INSTANCES_DELETEDelete VM instances

Admin WebPlates

NodeConstantGrants
admin.webplates.viewADMIN_WEBPLATES_VIEWView webplates
admin.webplates.createADMIN_WEBPLATES_CREATECreate new webplates
admin.webplates.editADMIN_WEBPLATES_EDITEdit existing webplates
admin.webplates.deleteADMIN_WEBPLATES_DELETEDelete webplates

Admin WebSpaces

NodeConstantGrants
admin.webspaces.viewADMIN_WEBSPACES_VIEWView webspaces
admin.webspaces.createADMIN_WEBSPACES_CREATECreate new webspaces
admin.webspaces.editADMIN_WEBSPACES_EDITEdit existing webspaces
admin.webspaces.deleteADMIN_WEBSPACES_DELETEDelete webspaces

Admin Wings Backups

NodeConstantGrants
admin.wings_backups.viewADMIN_WINGS_BACKUPS_VIEWView Wings backups
admin.wings_backups.manageADMIN_WINGS_BACKUPS_MANAGEManage Wings backup settings
admin.wings_backups.runADMIN_WINGS_BACKUPS_RUNRun or trigger Wings backups

Game server subuser permissions

Shown on the server's Subusers page. The server owner always has all of them.

WebSocket

NodeNameAllows
websocket.connectConnectAllows a user to connect to the server console via WebSocket.

Control

NodeNameAllows
control.consoleConsoleAllows a user to send commands to the server instance via the console.
control.startStartAllows a user to start the server if it is stopped.
control.stopStopAllows a user to stop a server if it is running.
control.restartRestartAllows a user to perform a server restart. This allows them to start the server if it is offline, but not put the server in a completely stopped state.

User

NodeNameAllows
user.createCreateAllows a user to create new subusers for the server.
user.readReadAllows the user to view subusers and their permissions for the server.
user.updateUpdateAllows a user to modify other subusers.
user.deleteDeleteAllows a user to delete a subuser from the server.

File

NodeNameAllows
file.createCreateAllows a user to create additional files and folders via the Panel or direct upload.
file.readReadAllows a user to view the contents of a directory, but not view the contents of or download files.
file.read-contentRead ContentAllows a user to view the contents of a given file. This will also allow the user to download files.
file.updateUpdateAllows a user to update the contents of an existing file or directory.
file.deleteDeleteAllows a user to delete files or directories.
file.archiveArchiveAllows a user to archive the contents of a directory as well as decompress existing archives on the system.
file.sftpSFTPAllows a user to connect to SFTP and manage server files using the other assigned file permissions.

Backup

NodeNameAllows
backup.createCreateAllows a user to create new backups for this server.
backup.readReadAllows a user to view all backups that exist for this server.
backup.deleteDeleteAllows a user to remove backups from the system.
backup.downloadDownloadAllows a user to download a backup for the server. Danger: this allows a user to access all files for the server in the backup.
backup.restoreRestoreAllows a user to restore a backup for the server. Danger: this allows the user to delete all of the server files in the process.

Allocation

NodeNameAllows
allocation.readReadAllows a user to view all allocations currently assigned to this server. Users with any level of access to this server can always view the primary allocation.
allocation.createCreateAllows a user to assign additional allocations to the server.
allocation.updateUpdateAllows a user to change the primary server allocation and attach notes to each allocation.
allocation.deleteDeleteAllows a user to delete an allocation from the server.

Startup

NodeNameAllows
startup.readReadAllows a user to view the startup parameters for a server.
startup.updateUpdateAllows a user to modify startup parameters for a server.
startup.docker-imageUpdate Docker ImageAllows a user to modify the Docker image used for a server.

Templates

NodeNameAllows
templates.readReadAllows a user to view available server templates.
templates.installInstallAllows a user to install templates on the server.

Database

NodeNameAllows
database.createCreateAllows a user to create new databases for this server.
database.readReadAllows a user to view all databases that exist for this server.
database.updateUpdateAllows a user to view passwords for databases.
database.deleteDeleteAllows a user to remove databases from the system.
database.view_passwordview_password

Schedule

NodeNameAllows
schedule.createCreateAllows a user to create new schedules for this server.
schedule.readReadAllows a user to view all schedules that exist for this server.
schedule.updateUpdateAllows a user to modify schedules for a server.
schedule.deleteDeleteAllows a user to remove schedules from the system.

Settings

NodeNameAllows
settings.renameRenameAllows a user to rename a server.
settings.change-eggchange-egg
settings.reinstallReinstallAllows a user to trigger a server reinstallation.

Activity

NodeNameAllows
activity.readReadAllows a user to view server activity.

Subdomain

NodeNameAllows
subdomain.manageManageAllows a user to create, update, delete, and sync subdomains for this server.

Firewall

NodeNameAllows
firewall.readReadAllows a user to view the firewall rules for this server.
firewall.manageManageAllows a user to create, update, and delete firewall rules for this server.

Proxy

NodeNameAllows
proxy.readReadAllows a user to view the proxy rules for this server.
proxy.manageManageAllows a user to create, update, and delete proxy rules for this server.

Import

NodeNameAllows
import.readReadAllows a user to view server imports.
import.manageManageAllows a user to create and manage server imports.

WebSpace subuser permissions

WebSpaces (web hosting) have their own set, defined in WebSpaceSubuserPermissions.php.

AreaNodes
filefile.read file.read-content file.create file.update file.delete file.sftp
controlcontrol.start control.stop control.restart
consoleconsole.output console.send
backupbackup.read backup.create backup.delete backup.download backup.restore
activityactivity.read
settingssettings.read settings.update
scheduleschedule.read schedule.create schedule.update schedule.delete
useruser.read user.create user.update user.delete
databasedatabase.read database.create database.update database.delete database.view_password
mailmail.read mail.create mail.update mail.delete mail.view_password
dnsdns.read dns.manage