Skip to main content

What is an environment?

An environment is an isolated place for apps (for example dev, staging, or billing-prod). Create one before you deploy — without it, the app has nowhere to run.

UI label

Xooshe says environment. In Kubernetes this is a namespace. See Terms we use.

Why it matters​

  • Apps that should talk easily can share an environment.
  • Apps that should stay separate belong in different ones.
  • Deleting an environment removes everything inside it — treat that as irreversible.

Create one​

  1. Open Manage environments on the home dashboard.
  2. Choose Create environment.
  3. Enter a clear name (for example payments-dev).
  4. Confirm. You can now deploy apps into it.

Already have a namespace on the cluster? Import it instead of creating a duplicate.

Naming and mistakes​

  • Prefer my-app-dev over test or ns1.
  • Match how your team thinks about stages and products.
  • Do not delete an environment that still has apps or databases you need.
  • Do not mix “namespace”, “workspace”, and “environment” in your own runbooks — pick environment.