Instances. Run a second copy of an app for staging, a client or a demo.

An instance is one running copy of an app. Every app starts with prod. Add another for staging, a client or a demo:

hub app my-app instance create staging
hub deploy --name my-app --instance staging

The new instance answers at https://my-app--staging.<org>.myhub.host. hub deploy --instance staging also creates the instance when it does not exist yet.

What each instance keeps

Each instance has its own URL, releases, environment variables, access mode, logs and volumes. A deploy to staging leaves prod alone.

App invitations are the exception: an invitation covers every instance of the app. See Access and invitations.

Name an instance

Every hub app command takes app/instance as the name:

hub app my-app/staging status
hub app my-app/staging logs
hub app my-app/staging env set MODE=staging
hub app my-app/staging access private
hub app my-app/staging rm

my-app alone means my-app/prod. hub apps and the dashboard list an instance other than prod as my-app/staging.