forge explain
Explain a deployment failure.
Command
forge explain [deployment-id] [--json]
Arguments
| Name | Type | Required | Notes |
|---|---|---|---|
| string | no | Deployment ID; defaults to latest |
Flags
| Flag | Type | Default | Notes |
|---|---|---|---|
| bool | | Output as JSON |
Examples
Explain latest failure:
forge explain
# → Deployment deploy_xxxxx failed at stage "build"
# → Error: Docker build exceeded memory limit (4 GB)
# → Suggestion: Increase memory with --memory flag
Explain specific deployment:
forge explain deploy_xxxxx --json
Errors
| Exit code | Meaning |
|---|---|
| 0 | Success |
| 1 | Deployment not found |
Pitfalls
- Latest failure — without an ID, explains the most recent failed deployment for the linked project.
See also
{auto-injected}
Tested against
{auto-injected}