Skip to main content

Namespaces

Namespaces organize processes into logical groups for isolation and filtering.

Configuration​

processes:
  api:
    entrypoint: ./cmd/api
    namespace: production
  worker:
    entrypoint: worker.py
    namespace: production
  test-api:
    entrypoint: ./cmd/api
    namespace: staging

Default Namespace​

When no namespace is specified, processes are assigned to the default namespace.

Filtering​

Use the --namespace flag to filter by namespace:

# List only production processes
runix list --namespace production

# List only staging processes
runix list --namespace staging

Uniqueness​

Process names must be unique within a namespace. The same name can exist in different namespaces:

processes:
  api-prod:
    entrypoint: ./cmd/api
    namespace: production
    env:
      PORT: "8080"

  api-staging:
    entrypoint: ./cmd/api
    namespace: staging
    env:
      PORT: "9090"

What's Next​