Skip to main content
A Namespace is an account-owned organizational boundary. It groups related Workloads, Vault material, registry credentials, connectivity resources, and Computers. Use namespaces to separate environments, teams, applications, or other resource sets that should be listed and managed together.

What namespaces scope

Workload commands use a namespace when creating, listing, updating, or deleting workload resources. Examples of namespace-scoped resources include deployments, jobs, cron jobs, replica sets, and pods. A Computer belongs to one Namespace and lives in one Subnet. Computer names are unique within their Namespace and Subnet together. Commands select both scopes and name the Computer explicitly.

Namespace and subnet

Namespaces and subnets are separate concepts. A direct Workload is scoped to a Namespace and placed on a Subnet. It does not require a Computer. A Computer composes execution in its enclosing Namespace.

Entered Namespace

The CLI can store a namespace in the active context. Commands use the context namespace unless a command flag or manifest provides another value.