GitHub

Connect your GitHub repositories with dFlow and deploy applications seamlessly.

GitHub Integration: Using GitHub App

dFlow allows you to securely connect your GitHub repositories—both personal accounts and organizations—directly to your dFlow panel.
This integration makes it simple to deploy applications or Docker Compose services with just a few clicks.

Connection Options

When adding GitHub as a Git source in dFlow, you can choose:

• Organization → Connect repositories from your GitHub Organization.
• Personal Account (Default) → Connect repositories from your personal account.

How to Connect GitHub with dFlow

Follow these steps to set up the GitHub App integration:

1. In dFlow, click Create GitHub App.
2. Enter a unique App Name (e.g., dFlow-GitHub-App).
3. Click Create GitHub App → you will be redirected to the Git section in dFlow.
4. Click Install when prompted.
5. Select which repositories to grant access:
   • All repositories (recommended for full automation), or
   • Specific repositories (restricted access).
6. Click Install & Authorize to finish setup.
7. You will be redirected back to the Git section of dFlow.
8. Your GitHub repositories are now available in App services.

Using GitHub App in dFlow

To set up a service with the GitHub App:

1. Create a new service and select type as app.
2. Navigate to the GitHub tab and choose git-app.
3. Enter the required details such as account, repository, and branch.
4. Click Deploy to launch and view it live.