# Deploy issues

### When to use

* Deploy fails with error.
* Deploy is in progress and doesn't finish.
* Deploy completes, but the application doesn't start.

### Quick checklist (2 min)

1. Confirm the correct environment (Dev/Staging/Prod).
2. Run a new deploy. Avoid 'deploy spam'.
3. Check if there was a recent change to variables/secrets.

### Diagnosis

#### 1) Is the error build or runtime?

* **Build**: fails before publishing artifacts.
* **Runtime**: publishes, but crashes on startup or at endpoints.

#### 2) Environment configuration

* Are required variables set?
* Do integrations (API keys) exist in the correct environment?

#### 3) External dependencies

* Is the database accessible?
* Do webhooks and third-party services respond?

### How to resolve (patterns)

* **Build broke**: review recent changes and revert the last delta.
* **Runtime crashed**: check app logs and startup failure.
* **Intermittent error**: confirm limits (rate limit), timeout, and dependencies.

### When to escalate

* 5xx error in the pipeline is repeatable.
* Deploy stuck for more than 20 min.
* App with downtime in Staging/Prod.