renovate/lib/modules/platform/gitea
Sebastian Poxhofer 3681b2a945
chore: eslint to enforce for typed imports (#30844)
2024-08-19 13:15:27 +00:00
..
gitea-helper.spec.ts feat(gitea): filter and abort unusable repos (#28063) 2024-04-25 09:57:02 +00:00
gitea-helper.ts chore: eslint to enforce for typed imports (#30844) 2024-08-19 13:15:27 +00:00
index.spec.ts fix(gitea): wrong state for merged PR (#30398) 2024-07-26 10:39:04 +00:00
index.ts fix(platform): don't log if issues are disabled when closing (#30267) 2024-07-20 11:13:04 +00:00
pr-cache.ts refactor: Remove dependency on Gitea and Bitbucket types in cache (#27821) 2024-03-10 13:08:51 +00:00
readme.md docs(gitea): fix anchors (#28919) 2024-05-08 07:14:12 +00:00
schema.spec.ts fix(gitea): check for disabled issues (#26134) 2023-12-05 11:27:30 +00:00
schema.ts feat(changelog): support gitea changelogs (#24144) 2023-08-31 09:41:39 +00:00
types.ts fix(gitea): wrong state for merged PR (#30398) 2024-07-26 10:39:04 +00:00
utils.spec.ts feat(gitea): filter and abort unusable repos (#28063) 2024-04-25 09:57:02 +00:00
utils.ts fix(gitea): wrong state for merged PR (#30398) 2024-07-26 10:39:04 +00:00

readme.md

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 your config.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.