Troubleshooting overview

Start here for symptoms, logs, domains, env vars, compute, integrations, and billing. Task-oriented fixes with links back to guides.

Written By Zoro

Last updated 3 days ago

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 ServiceDeployment issues
Which log to read and what to captureLogs and debugging
Custom domain, DNS, or TLS errorsDomain and SSL issues
Variables not applied, wrong values, referencesEnvironment variable issues
SSH, Worker Node offline, disk, or capacityCompute and worker node issues
Git, registry, or cloud account connectionIntegration 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

  1. Pick the symptom that matches your situation.

  2. Follow the checks in order; they are written to avoid repeating support back-and-forth.

  3. When a step points at a task, open that page from Deployments and Operations, Integrations, or the matching section in the sidebar.

  4. If nothing fits, read When to contact support and gather the artifacts listed there.

Related