3.0

Highlights

Restore works when Docker is down. restore no longer needs Container Manager running, and the script never replaces binaries while Docker is still shutting down. Stop timeouts and start failures now report what's happening instead of a generic error.

iptables modules survive Container Manager updates. On DSM 7, the iptable_raw / ip6table_raw modules now load from a systemd drop-in instead of lines inserted into Synology's start-stop-status, which package updates overwrite. Existing setups are migrated automatically.

fuse-overlayfs for aufs setups (opt-in). For volumes on aufs with no kernel overlay support, which have no usable storage driver on Docker 24+, --fuse-overlayfs sets up fuse-overlayfs storage. Based on @doctorpangloss's work in AppMana's fork.

What's Changed

Container Manager handling (#88) - #110

• restore works with Container Manager stopped or broken; update and the other commands say how to start it instead of suggesting --force
• The stop step waits out a stopping state and never continues while dockerd is running, fixing a case where binaries could be replaced under a running daemon
• Separate messages for stop timeouts and start failures, with the package status, whether dockerd is running, and the daemon log path
• New start and stop commands
• README: tips for hosts with many containers, and rolling back when Docker won't start

fuse-overlayfs and systemd-loaded modules (#89) - #113

• fuse-overlayfs (opt-in):
  • New --fuse-overlayfs option and install_fuse_overlayfs.sh (with --uninstall)
  • Refuses to run on anything but aufs, so btrfs setups are never switched
  • Verifies every download against a pinned checksum
  • Keeps the data path of installs made with AppMana's fork
• Storage check: update / install stop with clear advice when dockerd.json still uses aufs and the target is Docker 24+, instead of leaving Docker unable to start
• Module loading: on DSM 7, iptables raw modules load via a systemd drop-in; the old insmod lines are removed from start-stop-status, and only_script migrates hosts already on the latest Docker

Fixes - #112

• --force and install now run the iptables-module and AppArmor steps for Docker 28+/29+; previously --force skipped both, and install never installed the AppArmor profile
• "Step X of Y" progress is now accurate, including with --target, Compose-only updates, and the local log driver

Upgrading

git pull, then update as usual. On DSM 7, the next update (or sudo ./syno_docker_update.sh only_script) moves module loading to the systemd drop-in and cleans up the old lines. Nothing changes for btrfs setups unless you pass --fuse-overlayfs.

Thanks

Thanks to @doctorpangloss for the fuse-overlayfs work from the AppMana fork, @telnetdoogie for review and on-device testing, and @liquidguru for the detailed stop/start reports in #88.

New Contributors

• @doctorpangloss: fuse-overlayfs support, from AppMana's fork

Full Changelog: 2.9...3.0

2.9

What's Changed

• Update download URLs for kernel modules by @telnetdoogie in #103
• fix: drop runc pin on Kernel 5.x unless bundled runc is affected; refresh stale pins by @bslatyer in #109

Full Changelog: 2.8...2.9

2.8

Important

We have moved the repository to a new home to make it easier to maintain and add new projects.

https://github.com/telnetdoogie-labs/synology-docker

What's Changed

• Update repository links in README.md by @telnetdoogie in #100
• chore: repository move by @bslatyer in #101
• Add contributor acknowledgment for AppArmor update by @telnetdoogie in #102

Full Changelog: 2.7.1...2.8

2.7.1

What's Changed

• [FR] fix: Docker 29 Segmentation Faults by @auddis in #98

New Contributors

• @auddis made their first contribution in #98

Full Changelog: 2.7...2.7.1

2.7

What's Changed

• docs: update README formatting and improve clarity of warnings and notes by @bslatyer in #87
• fix: SC2181 by @bslatyer in #91
• [FR] fix: resolve helper scripts via SCRIPT_DIR, and guard jq array access for mountless containers by @liquidguru in #96
• [FR] Fix start-stop-status ordering for FORWARD rules; add AppArmor profile install to unbreak Docker 29.x by @Salvora in #95

New Contributors

• @liquidguru made their first contribution in #96
• @Salvora made their first contribution in #95

Full Changelog: 2.6.2...2.7

2.6.2

What's Changed

• chore: restructure issue templates for improved clarity and usability by @bslatyer in #67
• chore: update stale workflow configuration for improved functionality and clarity by @bslatyer in #68
• refactor: code structure for improved readability and maintainability by @bslatyer in #69
• chore: update feature request label and add CODEOWNERS file by @bslatyer in #71
• chore: add title field to bug and feature issue templates by @bslatyer in #72
• feat: add issue and pull request templates, configure dependabot and release settings by @bslatyer in #74
• revise: advise about Docker 29.x issues and rollback option(s) by @bslatyer in #79
• Fix synopkg/synoservicectl PATH resolution under sudo on DSM by @ccarpinteri in #84

New Contributors

• @ccarpinteri made their first contribution in #84

Full Changelog: 2.6.1...2.6.2

2.6.1

What's Changed

• Fix Docker service name for compatibility by @michelderooij in #59
• fix: improve Docker Compose version detection and validation by @bslatyer in #60
• Update README.md by @telnetdoogie in #61
• fix: update stale workflow configuration for improved issue and PR management by @bslatyer in #62
• Improve script to locate start-stop-status for Docker by @telnetdoogie in #64
  • Should fix #63

New Contributors

• @michelderooij made their first contribution in #59
• @bslatyer made their first contribution in #60

Full Changelog: 2.6.0...2.6.1

2.6.0 - Update for 5.5 kernel and Docker v29+

What's Changed

• Update important warnings in README by @telnetdoogie in #53
• feat: download pinned runc for Kernel 5.x by @bslatyer and @telnetdoogie in #54

Full Changelog: 2.5.0...2.6.0

epyc7002 modules published

What's Changed

• epyc modules published for 5.5 kernel
• option to skip iptables modules install by @telnetdoogie in #36
  Full Changelog: 2.4.1...2.5.1

Updated Script for Docker v29

What's Changed

• option to skip iptables modules install by @telnetdoogie in #36
• fixed installation of modules for versions 28 (wasn't triggering for v29)
  Full Changelog: 2.4.1...2.5.0