Auto-create books directory, log upload errors, document Docker deployment

- library.New now creates BOOKS_DIR (MkdirAll) on startup so uploads
  don't fail when the directory is missing on a fresh bind mount
- uploadSubmit logs the underlying OS error on save/write failures
- README: document docker-compose deployment, container UID/GID (100/101)
  for bind-mounted ./data permissions, and running the admin CLI via
  docker compose exec

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
2026-08-15 07:11:33 +02:00
co-authored by Copilot
parent 4c0aa053ac
commit 0c3e5cec9f
4 changed files with 74 additions and 3 deletions
+62
View File
@@ -74,6 +74,68 @@ go run ./cmd/admin user delete <name>
go run ./cmd/admin user set-role <name> <reader|uploader|admin>
```
## Docker / docker-compose Deployment
Beispiel `docker-compose.yml`:
```yaml
version: '3'
networks:
web:
external: true
services:
app:
image: git.arnef.de/arnef/ebooks:latest
restart: always
networks:
- web
volumes:
- ./data:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
labels:
traefik.enable: 'true'
traefik.http.routers.ebooks.rule: Host(`books.arnef.de`)
traefik.http.routers.ebooks.entrypoints: websecure
traefik.http.routers.ebooks.tls.certresolver: letsencrypt
traefik.http.services.ebooks.loadbalancer.server.port: 8080
```
Der Container läuft als nicht-root Benutzer `ebooks` (UID `100`, GID `101`).
`BOOKS_DIR` (`/data/books`) und `USERS_DB` (`/data/users.db`) liegen im
Volume `./data`. Der Server legt `BOOKS_DIR` beim Start automatisch an,
falls es fehlt — gehört das Host-Verzeichnis `./data` aber nicht dem
passenden UID/GID, schlägt das Anlegen fehl bzw. `users.db` kann nicht
geöffnet werden (`unable to open database file`) und Uploads schlagen mit
"Datei konnte nicht gespeichert werden" fehl.
1. Datenverzeichnis anlegen und Rechte setzen:
```bash
mkdir -p data
sudo chown -R 100:101 data
```
2. Container starten:
```bash
docker compose up -d
```
3. Ersten Benutzer über die im Image enthaltene Admin-CLI anlegen (der
Server muss dafür nicht gestoppt werden, `--role admin` empfohlen für
den ersten Account):
```bash
docker compose exec app /app/admin user add <name> --role admin
docker compose exec app /app/admin user list
```
`USERS_DB` ist im Image bereits auf `/data/users.db` gesetzt, daher ist
kein zusätzlicher Parameter nötig.
## Konfiguration
Umgebungsvariablen: