Gitea and Forgejo¶
Renovate supports Gitea and the Forgejo fork.
Forgejo exists since v1.18.0
and is currently fully compatible to Gitea.
Authentication¶
First, create a Personal Access Token (PAT) for the bot account. The bot account should have full name and email address configured. Then let Renovate use your PAT by doing one of the following:
- Set your PAT as a
token
in yourconfig.js
file - Set your PAT as an environment variable
RENOVATE_TOKEN
- Set your PAT when you run Renovate in the CLI with
--token=
You must set platform=gitea
in your Renovate config file.
The PAT should have these permissions:
Scope | Permission | Valid for Gitea versions | Notes |
---|---|---|---|
repo |
Read and Write |
all | |
user |
Read |
all | |
issue |
Read and Write |
>= 1.20.0 |
|
organization |
Read |
>= 1.20.0 |
Required to read group labels |
email |
Read |
<= 1.19.3 |
|
misc |
Read |
Only for 1.20.0 and 1.20.1 |
If you use Gitea packages, add the read:packages
scope.
Unsupported platform features/concepts¶
- Adding reviewers to PRs not supported: Gitea versions older than
v1.14.0
do not have the required API. platformAutomerge
(true
by default) for platform-native automerge not supported: Gitea versions older than v1.17.0 do not have the required API.- Git upload filters: If you're using a Gitea version older than
v1.16.0
then you must enable clone filters.
Features awaiting implementation¶
- none
Repo autodiscover¶
Renovate can discover repositories on Gitea using the autodiscover
feature.
Repositories are ignored when one of the following conditions is met:
- The repository is a
mirror
- We do not have push or pull permissions to that repository
- Pull requests are disabled for that repository
You can change the default server-side sort method and order for autodiscover API.
Set those via autodiscoverRepoSort
and autodiscoverRepoOrder
.
Read the Gitea swagger docs for more details.
Open items¶
The below list of features and bugs were current when this page was generated on August 25, 2024.
Feature requests¶
- Use
gitea-refs
for Gitea / ForgejoActions #28120 - [Gitea] implement getBranchForceRebase #27055
- Gitea: set
update_at
field when updating issues #26868 - [gitea] Improve repo caching for unchanged data #26809
- Gitea: use repo topic as a cache #18921
Bug reports¶
- Gitea PR list cache does not detect deleted PRs #28511