Skip to main content
A Namespace is an account-owned organizational boundary. It groups related Workloads, Vault material, registry credentials, connectivity resources, and Workspaces. 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 Workspace is created within one Namespace. Workspace names are unique within that Namespace, so its full user-facing address is <namespace>/<workspace>.

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 Workspace. A Workspace Run composes a Workload in the Workspace’s 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.