diff --git a/dev/README.md b/dev/README.md
new file mode 100644
index 0000000..e743e0c
--- /dev/null
+++ b/dev/README.md
@@ -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.
diff --git a/dev/compose.yaml b/dev/compose.yaml
index fae8126..31d2755 100644
--- a/dev/compose.yaml
+++ b/dev/compose.yaml
@@ -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: