# Renovate Bot for Gitea Setup

**Last Updated:** 2026-02-10

---

## Overview

Renovate automatically creates PRs for dependency updates. This doc covers self-hosted Renovate with Gitea.

## Option 1: Renovate via Gitea Actions (when act_runner is running)

Create `.gitea/workflows/renovate.yml` to run Renovate on a schedule:

```yaml
name: Renovate
on:
  schedule:
    - cron: '0 5 * * 1'
  workflow_dispatch:
jobs:
  renovate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: renovate/renovate@v40
        env:
          RENOVATE_TOKEN: ${{ secrets.GITEA_TOKEN }}
          RENOVATE_PLATFORM: gitea
          RENOVATE_ENDPOINT: https://gitea.d-bis.org
```

Note: Renovate Action may require Gitea-specific configuration.

## Option 2: Self-Hosted Renovate (Docker)

Run Renovate as a container:

```bash
docker run -e RENOVATE_TOKEN=<gitea_token> \
  -e RENOVATE_PLATFORM=gitea \
  -e RENOVATE_ENDPOINT=https://gitea.d-bis.org \
  -e RENOVATE_AUTODISCOVER=true \
  renovate/renovate
```

Or use docker-compose with a config file.

## Repository Config

Each repo can have `renovate.json` in the root. The proxmox repo includes:

```json
{
  "extends": ["config:base"],
  "packageRules": [{
    "updateTypes": ["minor", "patch", "pin", "digest"],
    "automerge": false
  }],
  "schedule": ["before 6am on monday"]
}
```

## Gitea Token

Create a Gitea PAT with: `repo` (read/write), `user` (read), `issue` (read/write).

## References

- [Renovate Gitea Platform](https://docs.renovatebot.com/modules/platform/gitea/)
- [Gitea + Renovate Tutorial](https://about.gitea.com/resources/tutorials/use-gitea-and-renovate-bot-to-automatically-monitor-software-packages)