Documentation / Release Notes

Current stable release: v1.0.4. Read the current release notes. The detailed v1.0.0 notes below are preserved as a historical reference. Download the current release.

Your Kitchen Library v1.0.3 — Stable Maintenance Release

Released October 22, 2026.

Version 1.0.3 includes the v1.0.2 Software Updates feature, all earlier installation, recipe import/export, navigation, and user-interface improvements, plus corrections informed by the first external Synology NAS installation and upgrade.

Fixes in 1.0.3

  • Synology upgrade no longer stops at a missing updater directory. During preflight the installer and upgrader reject symlinks and non-directory collisions at .recipe-site/updater. Before migrating the database, replacing files, or recreating the web container, the script creates the missing bind-mount source privately. Enabling actual in-app updates remains a separate, explicitly authorized root/Task Scheduler setup.
  • Synology without unzip is supported. The first-time upgrade kit uses installed Python 3 when unzip is unavailable, rejects unsafe archive contents, and still checks the application ZIP checksum before extraction.
  • Docker detection under sudo improved. Known Synology Container Manager/Docker executable paths are checked when the elevated shell has a restricted PATH. Existing .env access problems now have an actionable error message.
  • Interactive confirmation is reliable. The upgrade and installation commands read the approval word from the SSH terminal itself. Nested Docker commands cannot consume it.
  • Installation documentation and acceptance tests were expanded, including a real isolated v1.0.0-to-maintenance Docker upgrade with preserved Owner, media, database backups and code snapshots.

What's included from earlier versions

  • v1.0.2 Owner-only Software Updates screen, authenticated update request bridge, root-owned host updater, verified HTTPS stable catalog and SHA-256 release checks, Linux systemd and Synology DSM setup instructions.
  • v1.0.1 first-Owner installation and HTTP/HTTPS session fixes, improved recipe import/export, clean public recipe URLs, navigation and usability improvements.
  • Additional current-code maintenance for recipe features, parser interoperability, tooltip correctness and removal of redundant files.

Choose your package

  • Complete application: your-kitchen-library-1.0.3.zip — fresh installation and complete product source.
  • Easy upgrade kit: your-kitchen-library-easy-upgrade-1.0.3.zip — for an existing v1.0.0, v1.0.1, or v1.0.2 Linux/Synology Docker installation; extract into a separate folder and run bash UPDATE.sh.
  • Advanced upgrade kit: your-kitchen-library-upgrade-kit-1.0.3.zip — full verified application plus command-line transition script and instructions.
  • Each ZIP has a separate .sha256 checksum file.

For an existing installation, never run the fresh installer over your data or delete/recreate the database. Review the dry-run plan; the upgrader makes verified database and code snapshots before modification and preserves the existing .env, recipe images, accounts, database and compatible local configuration. Make an independent backup too. If a recovery error occurs, inspect the upgrade logs and backups before retrying.

Synology owner setup: in-app updating requires one administrator to enable the restricted host updater and configure a recurring root-owned DSM Task Scheduler task as documented in docs/UPDATER.md. Until that is configured, use the guided ZIP upgrade.

The official download site is https://yourkitchenlibrary.com/download/ . The original v1.0.0 through v1.0.2 release tags and binary packages remain available unchanged.