Troubleshooting
Troubleshooting overview
Start here for symptoms, logs, domains, env vars, compute, integrations, and billing. Task-oriented fixes with links back to guides.
Troubleshooting is primary navigation in dFlow docs, not an appendix. Use symptom-led pages below, then return to the matching task or concept guide when you know the fix.
Work inside the product model: Application → Environment → Service → Deployment, with Worker Nodes (or managed compute) executing work. If terms are unfamiliar, read How dFlow is structured first.
Quick map (question to doc)
| If you are asking… | Open |
|---|---|
| Sign-up, login, wizard, or “I cannot finish setup” | Getting started issues |
| Build failed, deploy stuck, rollback, unhealthy Service | Deployment issues |
| Which log to read and what to capture | Logs and debugging |
| Custom domain, DNS, or TLS errors | Domain and SSL issues |
| Variables not applied, wrong values, references | Environment variable issues |
| SSH, Worker Node offline, disk, or capacity | Compute and worker node issues |
| Git, registry, or cloud account connection | Integration issues |
| Payment, plan, or invoice (dFlow Cloud) | Billing issues |
| Database deploy, credentials, Expose, backups (database Service) | Database troubleshooting |
| Control plane install, Compose, Traefik (self-hosted operators) | Self-hosting troubleshooting |
How to use these pages
- Pick the symptom that matches your situation.
- Follow the checks in order; they are written to avoid repeating support back-and-forth.
- When a step points at a task, open that page from Deployments and Operations, Integrations, or the matching section in the sidebar.
- If nothing fits, read When to contact support and gather the artifacts listed there.
Related
- When to contact support
- Deployments overview
- Cloud limits and expectations (support scope on dFlow Cloud)