From fde5571620dcea88fa008571fa58e9bcc5141660 Mon Sep 17 00:00:00 2001 From: alexbelgium Date: Thu, 3 Sep 2026 15:19:01 +0200 Subject: [PATCH] fix(calibre-web): make kepubify executable so Kobo sync can be enabled The LinuxServer base image installs kepubify with `curl -o /usr/bin/kepubify` and never marks it executable, so the file ships as mode 0644. Calibre-web's resolve_binary_path() only accepts a binary that passes os.access(X_OK), so enabling Kobo sync failed with "Kepubify binary not found" even when the path was set to /usr/bin by hand. Verified against the published layer of lscr.io/linuxserver/calibre-web:arm64v8-latest, whose tar header for usr/bin/kepubify reads `-rw-r--r-- 0/0 3670016`. Set mode 0755 on it at build time, unguarded: if a future base image stops shipping the binary, the build should fail rather than ship a broken add-on. Calibre-web separately only autodetects kepubify under /opt/kepubify, never /usr/bin, so the setting was stored empty on the first start and never retried. Fill it in with /usr/bin from the cont-init script that already applies conditional settings to app.db, and only while it is still empty, so a path the user set by hand is never overwritten. Fixes https://github.com/alexbelgium/hassio-addons/issues/3040 Co-Authored-By: Claude Opus 5 --- calibre_web/CHANGELOG.md | 4 ++++ calibre_web/Dockerfile | 7 ++++++- calibre_web/config.yaml | 2 +- calibre_web/rootfs/etc/cont-init.d/80-configuration.sh | 7 +++++++ 4 files changed, 18 insertions(+), 2 deletions(-) diff --git a/calibre_web/CHANGELOG.md b/calibre_web/CHANGELOG.md index 13ad1f232a..70acafb852 100644 --- a/calibre_web/CHANGELOG.md +++ b/calibre_web/CHANGELOG.md @@ -1,4 +1,8 @@ +## 0.6.27.4 (2026-09-03) +- Fix: Kobo sync could not be enabled, failing with "Kepubify binary not found" even when the path was set to `/usr/bin` by hand. The LinuxServer base image downloads `/usr/bin/kepubify` with `curl -o` and never marks it executable (mode 0644), and calibre-web only accepts a binary that passes `os.access(X_OK)`. The addon now sets mode 0755 on it at build time (https://github.com/alexbelgium/hassio-addons/issues/3040) +- Fix: calibre-web only looks for kepubify under `/opt/kepubify`, never `/usr/bin` where the base image puts it, so the kepubify path was stored empty on the first start and never retried. The addon now fills it in with `/usr/bin` when it is still empty, leaving a path set by hand untouched. On a brand new install `/config/app.db` does not exist yet during the first start, so the path is filled in on the second start, as is already the case for the ingress settings + ## 0.6.27.3 (2026-08-30) - Doc: explain in the README that Calibre-Web's optional extras (metadata, kobo, gdrive, gmail, goodreads, ldap, oauth, comics) are already installed by the LinuxServer base image, that `pip install calibreweb[...]` inside the container is useless and not persistent, and that the cover fields on the Edit Metadata page are gated on `Enable Uploads` plus the user's `Upload` permission (https://github.com/alexbelgium/hassio-addons/issues/1143) - Fix: remove the Dockerfile step that claimed to install the Calibre binaries into `/opt/calibre`. There is no `wget` in the image, so the command failed silently and left the layer empty; the binaries are and were provided at start by the default `linuxserver/mods:universal-calibre` docker mod diff --git a/calibre_web/Dockerfile b/calibre_web/Dockerfile index 5d68439cf1..07cfac7a00 100644 --- a/calibre_web/Dockerfile +++ b/calibre_web/Dockerfile @@ -45,8 +45,13 @@ ARG CONFIGLOCATION="/config" RUN chmod 744 /ha_lsio.sh && if grep -qr "lsio" /etc; then /ha_lsio.sh "$CONFIGLOCATION"; fi && rm /ha_lsio.sh # Specific images modifications +# The base image installs kepubify with "curl -o /usr/bin/kepubify" and never marks it executable, +# so calibre-web's resolve_binary_path() rejects it (it requires os.access(X_OK)) and enabling +# Kobo sync fails with "Kepubify binary not found". Unguarded on purpose: if a future base image +# stops shipping the binary, the build must fail here rather than ship a silently broken add-on. RUN \ - usermod --home /config abc + usermod --home /config abc \ + && chmod 0755 /usr/bin/kepubify ################## # 3 Install apps # diff --git a/calibre_web/config.yaml b/calibre_web/config.yaml index 0c23004c1a..fbc012e106 100644 --- a/calibre_web/config.yaml +++ b/calibre_web/config.yaml @@ -116,5 +116,5 @@ schema: slug: calibre-web udev: true url: https://github.com/alexbelgium/hassio-addons/tree/master/calibre_web -version: "0.6.27.3" +version: "0.6.27.4" video: true diff --git a/calibre_web/rootfs/etc/cont-init.d/80-configuration.sh b/calibre_web/rootfs/etc/cont-init.d/80-configuration.sh index 16a99a5f33..3194cbd83a 100755 --- a/calibre_web/rootfs/etc/cont-init.d/80-configuration.sh +++ b/calibre_web/rootfs/etc/cont-init.d/80-configuration.sh @@ -32,6 +32,13 @@ else # before calibre-web, so a failure here is not fatal : the next start applies it. trusted_ips_error=$(sqlite3 /config/app.db "update settings set config_reverse_proxy_trusted_ips='127.0.0.1,::1,::ffff:127.0.0.1,172.30.32.0/23,::ffff:172.30.32.0/119,'||coalesce(config_reverse_proxy_trusted_ips,'') where coalesce(config_reverse_proxy_trusted_ips,'') not like '%::ffff:172.30.32.0/119%'" 2>&1) || bashio::log.warning "Could not set the ingress trusted ip list, it will be applied at next start (${trusted_ips_error})" + + # Calibre-web only autodetects kepubify under /opt/kepubify, never /usr/bin where the base + # image puts it, so the setting is stored empty on the very first start and is never retried + # afterwards : every install ends up with an empty path and Kobo sync cannot be enabled. + # Filled in only when it is still empty, so a path the user set by hand is never overwritten. + kepubify_error=$(sqlite3 /config/app.db "update settings set config_kepubifypath='/usr/bin' where coalesce(config_kepubifypath,'') = ''" 2>&1) || + bashio::log.warning "Could not set the kepubify path, it will be applied at next start (${kepubify_error})" fi bashio::log.info "Default username:password is admin:admin123"