Files
docker-compose/dev/README.md
Sebastian Krüger 644c437b31 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>
2025-11-15 12:01:20 +01:00

1.4 KiB

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 ConfigurationPicture
  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 AdministrationActionsRunners
  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:

  • 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 SettingsAppearance.

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.