Skip to main content
Resources transition through several states during their lifecycle.

​
Status reference

StatusBadge colorDescription
PendingGrayResource created, waiting for provisioning to begin
ProvisioningYellowInfrastructure is being set up (namespace, database, Coder, TLS, DNS)
RunningGreenResource is healthy and accessible at subdomain.codewire.sh
FailedRedProvisioning encountered an error — can be retried
SuspendedOrangeResource suspended due to billing (trial expired or subscription cancelled). Data is preserved but the service is inaccessible. Resume by activating a subscription.
DeletingYellowInfrastructure teardown is in progress
DeletedGrayAll infrastructure has been destroyed

​
State transitions

                    ┌─────────────┐
                    │   Pending   │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
               ┌───▶│Provisioning │◀──┐
               │    └──────┬──────┘   │
               │           │          │
               │     ┌─────┴─────┐   │
               │     │           │   │
        ┌──────▼──┐ ┌▼────────┐  │   │
        │ Failed  │ │ Running │  │   │
        └─────────┘ └──┬───┬──┘  │   │
                       │   │     │   │
                ┌──────▼┐ ┌▼─────────┐
                │Suspend│ │ Deleting ││
                │  ed   │ └──────┬───┘│
                └───────┘        │    │
                          ┌──────▼──┐ │
                          │ Deleted │ │
                          └─────────┘ │
                                      │
        Retry ────────────────────────┘
        Upgrade / Reprovision ────────┘

​
What triggers transitions

TransitionTrigger
Pending → ProvisioningAutomatic — begins when resource is created
Provisioning → RunningAll infrastructure provisioned successfully
Provisioning → FailedA provisioning step encountered an error
Failed → ProvisioningUser clicks Retry Provisioning
Running → ProvisioningUser clicks Upgrade or Force Reprovision
Running → SuspendedTrial expired or subscription cancelled (automatic)
Suspended → RunningSubscription activated or resumed (automatic via reconciler)
Running → DeletingUser clicks Delete and confirms
Deleting → DeletedAll resources destroyed

​
Dashboard behavior

  • The dashboard polls every 5 seconds for status updates
  • Status badges update automatically — no page refresh needed
  • The Events tab shows detailed progress during provisioning