fix: remove deprecated Gravatar environment variables

- Remove GITEA__picture__* environment variables (deprecated in Gitea 1.18+)
- Gravatar must be configured via admin panel in modern Gitea versions
- Add README.md with post-installation configuration instructions
- Document Gravatar setup, runner registration, themes, and custom assets

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-11-15 12:01:20 +01:00
parent fbdca7c5a2
commit 644c437b31
2 changed files with 47 additions and 3 deletions

47
dev/README.md Normal file
View File

@@ -0,0 +1,47 @@
# 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.

View File

@@ -43,9 +43,6 @@ services:
GITEA__ui__THEMES: gitea-auto,gitea-light,gitea-dark,auto,edge-auto,edge-dark,edge-light,everforest-auto,everforest-dark,everforest-light,gruvbox-auto,gruvbox-dark,gruvbox-light,gruvbox-material-auto,gruvbox-material-dark,gruvbox-material-light,nord,palenight,soft-era,sonokai,sonokai-andromeda,sonokai-atlantis,sonokai-espresso,sonokai-maia,sonokai-shusia
GITEA__ui__DEFAULT_THEME: auto
GITEA__ui__ENABLE_FEED: true
GITEA__picture__ENABLE_FEDERATED_AVATAR: true
GITEA__picture__AVATAR_UPLOAD_PATH: /data/gitea/avatars
GITEA__picture__GRAVATAR_SOURCE: gravatar
networks:
- compose_network
labels: