Sebastian Krüger
485edffa48
Note that custom themes are available for manual selection but may not work as default 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 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
|
|
|
|
**Default Theme:** `gitea-dark` (built-in Gitea dark theme)
|
|
|
|
21 custom themes from [sainnhe/gitea-themes](https://git.sainnhe.dev/sainnhe/gitea-themes) are available for manual selection:
|
|
|
|
- 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**.
|
|
|
|
**Note:** Custom themes may not load as default theme due to Gitea's theme loading mechanism. They remain available for manual selection by users.
|
|
|
|
## 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.
|