Deploy from Forgejo
Eurobase deploys from a repository on your own Forgejo server the same way it does from GitHub: every push to the project’s branch starts a deployment. You link the repository once with a read-only access token limited to that repository, and a webhook, so Forgejo tells Eurobase about each push.
Your server works as long as Eurobase can reach it over HTTPS. For a repository on codeberg.org, follow Deploy from Codeberg. For a Gitea server, follow Deploy from Gitea.
Before you start
- Only the workspace owner can link repositories.
- The repository has at least one commit.
Step 1: Add the repository
- In Eurobase, open Git in the sidebar.
- Under GitLab and Forgejo, select Add repository.
- Paste the repository’s HTTPS URL, such as
https://git.example.com/team/app, into Repository URL and select Continue.
Step 2: Create a read-only token
Select Open token settings in Eurobase to open the right page on your Git host. Create the token as described below, copy it, paste it into Access token in Eurobase and select Connect. Your Git host shows the token only once.
| Field | Value |
|---|---|
| Token | New access token |
| Repository access | Specific repositories, then select this repository |
| Permission | repository: Read |
| Create | Generate token |
Step 3: Add the webhook
After Connect, Eurobase shows a URL and a secret. Fill in the webhook form on your Git host with these values and leave every other field as it is.
| Field | Value |
|---|---|
| Type | Gitea or Forgejo: both work. Open webhook form in Eurobase opens the Gitea form. |
| Target URL | The URL from Eurobase |
| Secret | The secret from Eurobase |
| Trigger on | Push events |
| Save | Add webhook |
Step 4: Confirm the first push
The repository shows Waiting for first push until Eurobase receives a delivery it can verify. Push a commit, or open the webhook on Forgejo and select Test delivery.
The status becomes Connected.
Step 5: Deploy from it
- Open your project’s Deployments and choose the repository under Repository.
- Choose the Branch and, in a repository with several apps, the Root directory.
- Select Save and Deploy. From then on, every push to that branch deploys.
If something doesn’t work
- Waiting for first push. Check the webhook’s recent deliveries on your Git host. If they failed, select Set up webhook next to the repository in Eurobase and paste the URL and the secret again.
- Use a read-only token. The token can write. Create one with read permissions only.
- The token can’t read this repository. The token was created for another repository or account.
- Push a commit to the repository first. The repository is empty.
- Stuck? Write to support@eurobase.dev.