Skip to main content

Permissions

Access in kixctl is verb-level: every action is a discrete permission, checked at the point it runs, so a role can be granted exactly the verbs it should have. Roles group permissions — see Users, roles, and permissions. This page is the catalog.

The seeded roles frame the tiers below: operator holds the day-to-day verbs but not the destructive deletes or the widest-blast-radius edits, which are admin; viewer is read-only.

Instances​

PermissionActionTier
instance.createCreate an instanceoperator
instance.startStart an instanceoperator
instance.stopStop an instanceoperator
instance.restartRestart an instanceoperator
instance.renameRename an instanceoperator
instance.config.updateEdit CPU and memory limits, nesting, autostartoperator
instance.deleteDelete an instance (root filesystem only)admin

Snapshots​

PermissionActionTier
snapshot.createCreate a snapshotoperator
snapshot.restoreRestore a snapshotoperator
snapshot.deleteDelete a snapshotoperator

Profiles​

PermissionActionTier
profile.attachAttach a profile to an instanceoperator
profile.detachDetach a profile from an instanceoperator
profile.updateEdit a profile definitionadmin

profile.update is admin-tier because a profile edit's blast radius is every instance that inherits it.

Deploy pools​

PermissionActionTier
pool.createCreate a pooloperator
pool.updateEdit a pooloperator
pool.promotePromote a pool with Update alloperator
pool.deleteDelete a pooladmin

Users​

PermissionActionTier
user.manageCreate and manage users and their rolesadmin

The deploy lifecycle actions — cutover, revert, reap — are driven from the Updates tab; pooled promotion is gated on pool.promote. Managed networks are created, edited, and removed under Settings → Network with the same operator-and-admin split, where destructive removal is the admin verb.