Files

T

arnefandCopilot 0c3e5cec9f 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>

2026-08-15 07:11:33 +02:00

3.4 KiB

Raw Blame History

eBook Library (Go + templ)

Minimalistische eBook-Bibliothek für den Tolino-Webbrowser.

Features (MVP)

Listet EPUB/PDF-Dateien aus books/
Detailseite pro Buch
Download-Link pro Buch (für Tolino)
Schlichtes, kontrastreiches UI ohne JavaScript-Abhängigkeit
Login-Pflicht (Session-Cookie, 30 Tage)
Optionaler Buch-Upload für berechtigte Benutzer

Voraussetzungen

Go 1.22+
templ

Templ CLI installieren:

go install github.com/a-h/templ/cmd/templ@latest

Start

Abhängigkeiten laden:

go mod tidy

Templates generieren:

templ generate

Ersten Benutzer anlegen:

go run ./cmd/admin user add <benutzername>
# mit Upload-Recht:
go run ./cmd/admin user add <benutzername> --upload

Server starten:

go run ./cmd/server

Browser öffnen:

http://localhost:8080

Bücher hinzufügen

Lege deine Dateien in den Ordner books/:

.epub (bevorzugt)
.pdf (optional)

Alternativ können Benutzer mit Upload-Recht Bücher direkt im Browser hochladen.

Benutzerverwaltung (CLI)

Rollen (aufsteigend): reader → uploader → admin

go run ./cmd/admin user add <name> [--role reader|uploader|admin]
go run ./cmd/admin user list
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:

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.

Datenverzeichnis anlegen und Rechte setzen:

mkdir -p data
sudo chown -R 100:101 data

Container starten:

docker compose up -d

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):

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:

Variable	Standard	Beschreibung
`ADDR`	`:8080`	Listen-Adresse des Servers
`BOOKS_DIR`	`books`	Verzeichnis mit Büchern
`USERS_DB`	`users.db`	Pfad zur SQLite-Benutzerdatenbank

3.4 KiB Raw Blame History