feat: dynamic env vars in docker-compose + GHCR image

docker-compose.yml:
- Image now pulls from ghcr.io/b0bbywan/go-odio-api:latest
- XDG_RUNTIME_DIR and DBUS_SESSION_BUS_ADDRESS read from host env
  with fallback to /run/user/${UID:-1000} derivation
- HOME read from host env (PulseAudio cookie path stays consistent)
- All XDG_RUNTIME_DIR-based volume paths use the variable instead
  of recalculating from UID

.env.example: documents optional overrides for non-bash shells (fish, etc.)

README: rewrite Docker section with quick-start steps, env var table,
and volume table — no more hardcoded 1000

https://claude.ai/code/session_01GwPe5tCsib8gdiU7UNfH1N

Author: claude

.env.example

@@ -0,0 +1,5 @@
+# These variables are read automatically from your shell environment (bash/zsh export them).
+# Uncomment and set only if `docker compose config` shows wrong values.
+#
+# UID=1000                              # run `id -u`
+# XDG_RUNTIME_DIR=/run/user/1000       # run `echo $XDG_RUNTIME_DIR`

README.md

@@ -213,38 +213,60 @@ systemctl --user start odio-api.service
 This ensures the Pulseaudio/Pipewire, user D-Bus session and XDG_RUNTIME_DIR are available even without an active login session.
 
 ### Docker
-You can also run odio as a container!
 
-#### Build
-Build the Go binary and Docker image
+A pre-built multi-arch image is available on GHCR (amd64, arm64, arm/v6, arm/v7):
+
+```
+ghcr.io/b0bbywan/go-odio-api:latest
+```
+
+To build locally instead:
 ```bash
-docker build -t odio:latest .
+docker build -t odio-api .
+```
+
+#### Quick start
+
+```bash
+# 1. Prepare configuration (bind: all required for Docker)
+cp share/config.yaml config.yaml
+# Edit config.yaml: set bind: all
+
+# 2. (Optional) Provide your PulseAudio cookie
+cp ~/.config/pulse/cookie ./cookie
+
+# 3. (Optional) Only needed if docker compose config shows wrong paths
+cp .env.example .env
+
+# 4. Start
+docker compose up -d
 ```
-The Dockerfile uses a multi-stage build to compile the Go binary and copy it into a minimal runtime image.
-**Note**: the image includes DBus so that DBus-dependent functionality works correctly inside the container.
 
-#### Run
-A docker-compose.yml is provided in the repository for the most common use cases. It runs the container as a non-root user (UID 1000) and mounts the necessary host directories for DBus, systemd, and PulseAudio. You can adapt it for more specific setups if needed
+The `docker-compose.yml` reads `UID`, `XDG_RUNTIME_DIR`, `HOME` and `DBUS_SESSION_BUS_ADDRESS`
+directly from your shell environment — no configuration needed for a standard Linux setup.
+See `.env.example` if your shell doesn't export these automatically (e.g. fish).
 
-Environment variables:
-- XDG_RUNTIME_DIR=/run/user/1000                            DBus and Pulse runtime directory
-- DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/1000/bus     user DBus session
-- HOME=/home/odio                                           ensures `PulseAudio cookie` is found
+Environment variables passed to the container:
 
-Volumes:
-- ./config.yaml                    (odio configuration)       (read-only)
-- /run/user/1000/bus               (user DBus session)        (read-only)
-- /run/user/1000/systemd           (user systemd folder)      (read-only)
-- /run/utmp                        (user systemd monitoring)  (read-only)
-- /var/run/dbus/system_bus_socket  (system DBus socket)       (read-only)
-- /run/user/1000/pulse             (PulseAudio socket)        (read-only)
-- ./cookie    (`PulseAudio cookie`: $HOME/.config/pulse/cookie) (read-only)
+| Variable | Source | Purpose |
+|---|---|---|
+| `XDG_RUNTIME_DIR` | host env → fallback `/run/user/$UID` | D-Bus and PulseAudio runtime directory |
+| `DBUS_SESSION_BUS_ADDRESS` | host env → fallback derived from `XDG_RUNTIME_DIR` | User D-Bus session socket |
+| `HOME` | host env → fallback `/home/odio` | PulseAudio cookie lookup path |
 
-The container exposes port 8018 by default and is configured to automatically restart unless stopped. With this configuration, audio and DBus-dependent functionality works seamlessly inside Docker.
+Volumes mounted (all read-only):
 
-**Note:** `bind` should be set to `all` in `config.yaml` for remote access with docker. Zeroconf won't work in bridge network mode. It's strongly advised against using host network mode.
+| Volume | Purpose |
+|---|---|
+| `./config.yaml` | odio configuration |
+| `$XDG_RUNTIME_DIR/bus` | user D-Bus session socket |
+| `$XDG_RUNTIME_DIR/systemd` | user systemd folder (utmp unavailable) |
+| `/run/utmp` | user systemd monitoring (utmp available) |
+| `/var/run/dbus/system_bus_socket` | system D-Bus socket |
+| `$XDG_RUNTIME_DIR/pulse` | PulseAudio socket |
+| `./cookie` → `$HOME/.config/pulse/cookie` | PulseAudio cookie |
 
-All mounts are read-only, minimizing the container’s ability to modify the host system.
+**Note:** `bind` must be set to `all` in `config.yaml` for Docker (bridge network). Zeroconf won't work in bridge network mode. Host network mode is strongly discouraged.
 
 #### Command-line Flags
 

docker-compose.yml

@@ -1,20 +1,20 @@
 services:
   odio:
-    image: odio:latest
+    image: ghcr.io/b0bbywan/go-odio-api:latest
     container_name: odio
     ports:
       - "8018:8018"
-    user: "1000:1000"
+    user: "${UID:-1000}:${UID:-1000}"
     environment:
-      XDG_RUNTIME_DIR: /run/user/1000
-      DBUS_SESSION_BUS_ADDRESS: unix:path=/run/user/1000/bus
-      HOME: /home/odio
+      XDG_RUNTIME_DIR: ${XDG_RUNTIME_DIR:-/run/user/${UID:-1000}}
+      DBUS_SESSION_BUS_ADDRESS: ${DBUS_SESSION_BUS_ADDRESS:-unix:path=/run/user/${UID:-1000}/bus}
+      HOME: ${HOME:-/home/odio}
     volumes:
-      - /run/user/1000/bus:/run/user/1000/bus:ro # DBUS_SESSION_BUS_ADDRESS socket
-      - /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket:ro # system systemd socket
-      - /run/user/1000/systemd:/run/user/1000/systemd:ro # user systemd folder if utmp unavailable
+      - ${XDG_RUNTIME_DIR:-/run/user/${UID:-1000}}/bus:${XDG_RUNTIME_DIR:-/run/user/${UID:-1000}}/bus:ro # DBUS_SESSION_BUS_ADDRESS socket
+      - /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket:ro # system dbus socket
+      - ${XDG_RUNTIME_DIR:-/run/user/${UID:-1000}}/systemd:${XDG_RUNTIME_DIR:-/run/user/${UID:-1000}}/systemd:ro # user systemd folder if utmp unavailable
       - /run/utmp:/run/utmp:ro # user systemd socket if utmp available
-      - /run/user/1000/pulse:/run/user/1000/pulse:ro # pulse socket
-      - ./cookie:/home/odio/.config/pulse/cookie:ro # pulse cookie
+      - ${XDG_RUNTIME_DIR:-/run/user/${UID:-1000}}/pulse:${XDG_RUNTIME_DIR:-/run/user/${UID:-1000}}/pulse:ro # pulse socket
+      - ./cookie:${HOME:-/home/odio}/.config/pulse/cookie:ro # pulse cookie
       - ./config.yaml:/etc/odio-api/config.yml:ro # odio config
     restart: unless-stopped