Deploy issues

Deploy failing, stuck, or app down after publishing.

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.