Gitea

Dokploy offers a way to connect your Gitea Repository to your Dokploy panel, you can use Organizations or personal accounts.

Go to Git and select Gitea as the source, then you can use the following options:

• Application ID: Select the application ID that you want to connect to Dokploy.
• Personal Secret: Select the secret that you want to connect to Dokploy.
• Organization Name(Optional): Select the organization name that you want to connect to Dokploy (Ideal for Gitea Organizations).

Follow the steps to connect your Gitea account to Dokploy:

1. Go to your Gitea instance's settings (e.g., https://gitea.com/user/settings/applications) and scroll to the Create a new OAuth2 Application.
2. Set Application Name: e.g., Dokploy-Gitea-App. Choose any name you want.
3. Redirect URI: Copy the Redirect URI from Dokploy. e.g., https://dokploy.com/api/providers/gitea/callback.
4. Check Confidential Client
5. Click on Create Application.
6. Copy the Client ID and Client Secret from Gitea and paste them in Dokploy's Gitea Modal section.
7. Click on Configure Gitea App.
8. That operation will save the Gitea Provider configuration and redirect you to Gitia to authorize Dokploy to have access.
9. Click on Authorize.
10. You will be redirected to the Git section of Dokploy.
11. Now you can use the repositories from your Gitea Account in Applications or Docker Compose services.

Setup Automatic Deployments

You can configure automatic deployments in Dokploy for the Following Services:

1. Applications
2. Docker Compose

The steps are the same for both services.

1. Go to either Applications or Docker Compose and go to Deployments Tab.
2. Copy the Webhook URL.
3. Go to your Gitea Account and select the repository.
4. In the left menu, select Settings and then Webhooks.
5. Click on Add Webhook.
6. Set the URL to the one you copied in the previous step.
7. In the Trigger section, select Push Events.
8. Click on Add Webhook.
9. Click on Save.
10. Now you have automatic deployments enabled for the selected repository.

Clarification on Automatic Deployments

By default, Dokploy will automatically deploy your application on the Branch you have selected.

e.g., Let's suppose you have an application in this way:

Repository: my-app Branch: feature

If you try to make a push on another branch e.g., main, Dokploy will not automatically deploy your application, because your application has selected feature as the Branch.

Normal