Files

Sebastian Krüger 485edffa48 docs: update README with gitea-dark as default theme

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>

2025-11-15 12:16:53 +01:00

1.7 KiB

Raw Blame History

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:

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

Runner Registration

To enable the Gitea Actions runner:

Go to Site Administration → Actions → Runners
Click Create new Runner
Copy the registration token
Add to .env: DEV_GITEA_RUNNER_TOKEN=<token>
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 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.

1.7 KiB Raw Blame History