Environments & lifecycle
Environments
An environment = a complete, isolated instance of your app. Main fields, lifecycle, dashboard.
Version v1.01 min read
Environments
📍 Where to find this in the UI — Infra → Environments tab (list); click an env for its full dashboard
An environment = a complete, isolated instance of your app.
Main fields of an environment
| Field | Example | Role |
|---|---|---|
env | dev / prod / staging | Environment type |
shortname | exemple | Short nickname of the app in this env |
slug | exemple-dev | Unique identifier of the environment (used in URLs) |
gitRef | main / dev / feature/X | Git branch watched by this env |
gitRefType | BRANCH / TAG / COMMIT | Type of Git reference |
autoDeployEnabled | true / false | Auto-deploy when a build on this ref succeeds |
Lifecycle of an env
textACTIVE → (pause) → PAUSED → (resume) → ACTIVE ↓ DELETING → (cleanup) → deleted
The environment dashboard
When you click on an environment, you get access to:
| Tab | Content |
|---|---|
| Summary | Overview (services up, last deploy, health) |
| Services | List of ServiceInstances with their runtime state |
| Deployments | History of deployed versions + rollback |
| Configuration | Variables and secrets of the env |
| Jobs | Scheduled tasks (cron jobs) |
| Databases | This env's DatabaseInstances |
| Storage | This env's StorageBucketInstances |
| URLs | This env's public URLs |
| Monitoring | Metrics, centralized logs |