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.