# Gitea Configuration

## Post-Installation Setup

After completing the Gitea installation at https://dev.pivoine.art, configure the following settings via the admin panel:

### Enable Gravatar Avatars

Since Gitea 1.18+, avatar settings are managed via the database, not configuration files:

1. Log in as admin
2. Go to **Site Administration** (top right menu)
3. Navigate to **Configuration** → **Picture**
4. Enable **Use Gravatar for avatars**
5. Optionally set **Gravatar Source** to `https://secure.gravatar.com/avatar/`
6. Save settings

### Runner Registration

To enable the Gitea Actions runner:

1. Go to **Site Administration** → **Actions** → **Runners**
2. Click **Create new Runner**
3. Copy the registration token
4. Add to `.env`: `DEV_GITEA_RUNNER_TOKEN=<token>`
5. Restart services: `ssh -A root@vps "cd ~/Projects/docker-compose && arty up -d"`

## Custom Themes

21 custom themes are available from [sainnhe/gitea-themes](https://git.sainnhe.dev/sainnhe/gitea-themes):

- Edge (auto, dark, light)
- Everforest (auto, dark, light)
- Gruvbox (auto, dark, light)
- Gruvbox Material (auto, dark, light)
- Nord, Palenight, Soft Era
- Sonokai (base + 5 variants)

Users can select their preferred theme in **Settings** → **Appearance**.

## Custom Logo & Favicon

Custom logo and favicon are mounted from `dev/custom/public/assets/img/`:
- `favicon.svg` - Browser favicon
- `logo.svg` - Gitea logo

To update, replace the SVG files and restart Gitea.