Skitflow
Git Sources

Gitea

Configure Gitea repositories for deployments. This includes setting up access tokens, repository names, and branches.

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

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

  • Client ID: The OAuth2 Client ID generated by your Gitea instance.
  • Client Secret: The OAuth2 Client Secret generated by your Gitea instance.
  • Organization Name(Optional): The organization name you want to connect to Skitflow (ideal for Gitea Organizations).

Follow the steps to connect your Gitea account to Skitflow:

  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., Skitflow-Gitea-App. Choose any name you want.
  3. Redirect URI: Copy the Redirect URI from Skitflow. e.g., https://skitflow.cloud/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 Skitflow's Gitea Modal section.
  7. Click on Configure Gitea App.
  8. That operation will save the Gitea Provider configuration and redirect you to Gitea to authorize Skitflow to have access.
  9. Click on Authorize.
  10. You will be redirected to the Git section of Skitflow.
  11. Now you can use the repositories from your Gitea Account in Applications or Docker Compose services.

Skitflow doesn't support Gitea Automatic deployments on each push you make to your repository.

Setup Automatic Deployments

You can configure automatic deployments in Skitflow 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, Skitflow 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, Skitflow will not automatically deploy your application, because your application has selected feature as the Branch.

In the case you want to have multiple applications in the same repository, e.g., (development, staging, production), you can create 3 Applications in Skitflow and select the branch in each of them.

This is very useful if you want to have multiple environments for the same application.

On this page