From b8b9b4143d148ad725e2ff51d462c5432b4f6562 Mon Sep 17 00:00:00 2001 From: Derek Cooper Date: Wed, 4 Nov 2026 21:45:53 -0800 Subject: [PATCH] added bindery --- Bindery/.env.example | 33 ++++++++++++++++++++++++++++++ Bindery/docker-compose-nfs.yaml | 36 +++++++++++++++++++++++++++++++++ README.md | 1 + 3 files changed, 70 insertions(+) create mode 100644 Bindery/.env.example create mode 100644 Bindery/docker-compose-nfs.yaml diff --git a/Bindery/.env.example b/Bindery/.env.example new file mode 100644 index 0000000..64b4172 --- /dev/null +++ b/Bindery/.env.example @@ -0,0 +1,33 @@ +# Bindery + +# Docker image tag to use (e.g. "latest" or a pinned version like "1.2.3") +BINDERY_VERSION=latest + +# IANA timezone name for the container (e.g. America/Chicago, America/New_York) +BINDERY_TZ=America/Los_Angeles + +# Host port to expose the Bindery web UI on +BINDERY_PORT=8787 + +# UID:GID the container runs as — must own (or have rw on) the NFS export and bind mount paths below +BINDERY_UID=1000 +BINDERY_GID=1000 + +# Log verbosity (debug, info, warn, error) +BINDERY_LOG_LEVEL=info + +# Bind mounts + +# Host path for the book library (e.g. /mnt/media/books) +BINDERY_BOOKS=/mnt/path/to/books + +# Host path for the download client's completed downloads (e.g. /mnt/downloads) +BINDERY_DOWNLOADS=/mnt/path/to/downloads + +# NFS (config volume) + +# IP address or hostname of the NFS server +BINDERY_NFS_SERVER=192.168.1.x + +# NFS export path for config, SQLite DB and backups (e.g. :/mnt/pool/bindery) +BINDERY_NFS_DEVICE=:/path/to/nfs/share diff --git a/Bindery/docker-compose-nfs.yaml b/Bindery/docker-compose-nfs.yaml new file mode 100644 index 0000000..59ffaf0 --- /dev/null +++ b/Bindery/docker-compose-nfs.yaml @@ -0,0 +1,36 @@ +services: + app: + image: ghcr.io/vavallee/bindery:${BINDERY_VERSION:-latest} + container_name: bindery-app + # Image is distroless and can't switch users at runtime — this UID:GID must own the NFS export and bind mount paths + user: "${BINDERY_UID:-1000}:${BINDERY_GID:-1000}" + environment: + - TZ=${BINDERY_TZ:-America/Los_Angeles} + - BINDERY_LOG_LEVEL=${BINDERY_LOG_LEVEL:-info} + ports: + - ${BINDERY_PORT:-8787}:8787 + volumes: + - bindery-config:/config + - ${BINDERY_BOOKS}:/books + - ${BINDERY_DOWNLOADS}:/downloads + # No shell/curl in the distroless image — test is inherited from the image's built-in + # HEALTHCHECK (runs the binary's healthcheck subcommand against /api/v1/health) + healthcheck: + interval: 30s + timeout: 10s + retries: 5 + start_period: 30s + deploy: + resources: + limits: + memory: 512M + restart: unless-stopped + +volumes: + bindery-config: + name: bindery-config + driver: local + driver_opts: + type: nfs + o: "addr=${BINDERY_NFS_SERVER},rw,noatime,rsize=65536,wsize=65536,timeo=600,nfsvers=4" + device: "${BINDERY_NFS_DEVICE}" diff --git a/README.md b/README.md index ecc97db..a785b8d 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,7 @@ Feel free to use any of these as a starting point for your own setup. Each appli |-------------|-------------|-------|-------------| | Airtrail | Self-hosted personal flight tracking and logbook application | [NFS](./Airtrail/docker-compose-nfs.yaml) | [Read the article](https://chns.tech/posts/2024/10-06-airtrail-airline-flight-history-tracker-and-map/) | | BabyBuddy | Self-hosted baby tracking app for sleep, feeding, diaper changes, and milestones | [NFS](./BabyBuddy/docker-compose-nfs.yaml) | [Read the article](#) | +| Bindery | Self-hosted book and audiobook collection manager that monitors authors and automates downloads | [NFS](./Bindery/docker-compose-nfs.yaml) | [Read the article](#) | | ByteStash | Self-hosted code snippet manager with tagging, search, and syntax highlighting | [NFS](./ByteStash/docker-compose-nfs.yaml) | [Read the article](https://chns.tech/posts/2024/10-27-bytestash-code-snippet-organizer/) | | Discourse | Open-source community discussion platform and forum software | [Compose](./Discourse/docker-compose.yaml) | [Read the article](#) | | Dockhand | Self-hosted Docker stack management dashboard with remote agent support | [Volume](./Dockhand/docker-compose-volume.yaml) | [Read the article](https://chns.tech/posts/2026/05-01-dockhand-docker-management-dashboard/) |