Update README for multi-stage Docker build, add USER_AGENT env var

This commit is contained in:
2026-07-07 16:26:53 +02:00
parent 34fcc54cad
commit 7e3e1be47a
2 changed files with 31 additions and 31 deletions
+7 -7
View File
@@ -49,12 +49,11 @@ java -jar target/quarkus-app/quarkus-run.jar
### Docker
```bash
# Build the JAR
mvn clean package
Multi-stage build — no host pre-build needed, Maven runs inside the container.
# Build the image (from project root)
docker build -f src/main/docker/Dockerfile.jvm -t discdrop .
```bash
# Build (from project root)
docker build -t discdrop .
# Run
docker run -p 8080:8080 \
@@ -72,10 +71,11 @@ All configuration is via environment variables:
| Variable | Default | Description |
|----------|---------|-------------|
| `DISC_DROP_DB_PATH` | `data/discdrop.db` | Path to the SQLite database file |
| `DISC_DROP_CACHE_TTL` | `8` | Cache TTL in hours (how often release groups are refreshed from MusicBrainz) |
| `DISC_DROP_CACHE_TTL` | `8` | Cache TTL in hours |
| `DISC_DROP_BASE_URL` | `http://localhost:8080` | Public URL for RSS feed links |
| `DISC_DROP_USER_AGENT` | `DiscDrop/1.0 (https://gitea.t3du.com/…)` | User-Agent sent to MusicBrainz API |
The MusicBrainz User-Agent is set to `DiscDrop/1.0 (david.alvarez.81@gmail.com)` per [MusicBrainz API etiquette](https://musicbrainz.org/doc/MusicBrainz_API/Rate_Limiting).
The User-Agent header is sent with every MusicBrainz API request per [their etiquette](https://musicbrainz.org/doc/MusicBrainz_API/Rate_Limiting#Provide_meaningful_User-Agent_strings). It can be changed via `DISC_DROP_USER_AGENT`.
---