Getting started issues

Fix common first-time problems: account access, dashboard navigation, wizard drafts, and blockers before the first deployment.

Written By Zoro

Last updated 3 days ago

These patterns show up before or during your first successful Deployment.

If the failure happens during build or runtime, also read Deployment issues and Logs and debugging.

I cannot sign in or I never received email

  1. Confirm you are using the correct URL (app.dflow.sh for dFlow Cloud, or your self-hosted dashboard URL).
  2. Check spam or filtered folders for verification mail.
  3. Try password reset or sign-in again after a few minutes (transient provider delays).
  4. Self-hosted operators: verify outgoing email configuration in Email and outgoing services under Self-Hosting dFlow in the sidebar and Self-hosting troubleshooting under Self-Hosting dFlow in the sidebar.

Task guide: Create your account and workspace under Getting Started in the sidebar.

The dashboard looks empty or I cannot find Applications

  1. Confirm you are inside the intended Organisation (tenant). Invited users may need to accept an invite first.
  2. Use the navigation entry for Applications from the organisation context. If you only see legacy Projects, read Legacy Projects vs Applications under Core Concepts in the sidebar and Migrate from legacy Projects to Applications under Migration and Release Notes in the sidebar.

Task guide: First login and dashboard tour under Getting Started in the sidebar.

The Create New Application wizard will not finish

  1. Draft Applications can be continued with Continue setup. If the UI blocks a step, read the inline message first (often compute or permissions).
  2. Compute step: you need an eligible Worker Node or managed compute path. See Compute and worker node issues and Attach compute to an environment under Environments in the sidebar.
  3. Services step: activation is required to leave draft for active. If adding a Service fails, see Create a service under Services in the sidebar and Deployment issues.

Task guide: Create an application under Applications in the sidebar.

I am blocked before any deploy (Git, template, or database)

  • Git-backed app: Connect your Git provider under dFlow Cloud in the sidebar and Integration issues.
  • First deploy from repo or image: Deploy your first app under Getting Started in the sidebar.
  • Database: Create your first database under Getting Started in the sidebar and Databases overview under Databases in the sidebar.

Self-hosted control plane problems

If the failure is installing or reaching the dashboard itself (Compose, TLS, networking), use Self-hosting troubleshooting under Self-Hosting dFlow in the sidebar and Install with Docker / Docker Compose under Self-Hosting dFlow in the sidebar. Worker Node SSH and Dokku issues on your servers still belong under Compute and worker node issues.

Related