dFlow
Guides

Deploy an app

Add a Git-backed App Service to an Environment and deploy it on dFlow Cloud.

An App Service runs a web workload built from Git. Use this guide when you want dFlow to build and deploy a repository onto a Worker Node.

Prerequisites

  • An Application with a Worker Node attached (see Getting Started).
  • A Git repository. For private repos, connect a provider under Integrations.

1. Create an App Service

  1. Open your Application and target Environment.
  2. Choose Create Service / Add new and pick App.
  3. Set a name (lowercase letters, numbers, hyphens).

2. Connect Git

  1. Choose the provider (GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, or as shown in the UI).
  2. For private repos, complete OAuth or paste a token as prompted.
  3. Set repository and branch.
  4. Choose manual or automatic deploy when offered.

Automatic deployment on git push is supported for GitHub and GitLab integrations: when enabled, pushes to the configured branch start a new Deployment without clicking Deploy in the dashboard. Other providers may be manual-only depending on the UI.

3. Configure build and variables

  1. Set build / install commands and root directory if your app needs them.
  2. Add environment variables (static values, secrets, or reference variables to a database Service).
  3. Save.

4. Deploy

  1. Click Deploy or Redeploy.
  2. Watch build / deploy logs until the Deployment succeeds.
  3. Optionally attach a domain under Deployments and Operations.

Expected outcome: The App Service shows a successful Deployment and is reachable (or listed as running) in the UI.

If something fails

  • Deployment issues under Troubleshooting
  • Integration issues (Git / tokens)
  • Logs under Deployments and Operations

Go deeper

On this page