[PR #61] [MERGED] Update Docker version handling for CasaOS compatibility #73

Open
opened 2025-11-20 04:14:30 -05:00 by saavagebueno · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/bigbeartechworld/big-bear-scripts/pull/61
Author: @dragonfire1119
Created: 11/13/2025
Status: Merged
Merged: 11/14/2025
Merged by: @dragonfire1119

Base: masterHead: check-docker-availability


📝 Commits (3)

  • 2819848 Update Docker version handling for CasaOS compatibility
  • f6e5dfa Update Debian trixie and Raspberry Pi OS guidance
  • d9ab3a8 Resolve Docker and containerd versions at runtime

📊 Changes

1 file changed (+184 additions, -46 deletions)

View changed files

📝 casaos-fix-docker-api-version/run.sh (+184 -46)

📄 Description

This pull request updates the CasaOS Docker Version Fix Script to improve compatibility checks and installation robustness for Docker 24.0.x. The script now verifies Docker 24.0.x package availability for the user's OS version, installs the latest matching version rather than a hardcoded one, and provides clearer messaging and fallback logic during installation. These changes help prevent installation on unsupported OS versions and ensure users receive the most compatible Docker release for CasaOS.

Compatibility and OS Detection Improvements:

  • Added the check_docker_availability function to detect if Docker 24.0.x is available for the user's OS version (Debian trixie, Ubuntu noble/oracular are now flagged as unsupported), with detailed error messages and recommended solutions. [1] [2]
  • Updated script messaging and step order to verify Docker version availability before proceeding with other checks. [1] [2]

Installation Logic Enhancements:

  • Changed version variables to use a pattern (5:24.0.*) for installing the latest available Docker 24.0.x, and updated installation commands and fallback logic to match any suitable 24.0.x version. [1] [2] [3]
  • Improved fallback handling for containerd.io installation, trying version patterns if exact matches fail, and clarified error messaging for failed installations.

Messaging and Documentation Updates:

  • Updated all user-facing messages, instructions, and version references to refer to "Docker 24.0.x" instead of the specific "24.0.7" version, reflecting the more flexible installation logic. [1] [2] [3] [4] [5] [6]

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/bigbeartechworld/big-bear-scripts/pull/61 **Author:** [@dragonfire1119](https://github.com/dragonfire1119) **Created:** 11/13/2025 **Status:** ✅ Merged **Merged:** 11/14/2025 **Merged by:** [@dragonfire1119](https://github.com/dragonfire1119) **Base:** `master` ← **Head:** `check-docker-availability` --- ### 📝 Commits (3) - [`2819848`](https://github.com/bigbeartechworld/big-bear-scripts/commit/2819848a6633ffa166a5c6d7a8f8b8e71bc3b628) Update Docker version handling for CasaOS compatibility - [`f6e5dfa`](https://github.com/bigbeartechworld/big-bear-scripts/commit/f6e5dfae9cf5dcd038c2bb11702211ff12762d77) Update Debian trixie and Raspberry Pi OS guidance - [`d9ab3a8`](https://github.com/bigbeartechworld/big-bear-scripts/commit/d9ab3a82e01d900bf698e405c503420835f0ce46) Resolve Docker and containerd versions at runtime ### 📊 Changes **1 file changed** (+184 additions, -46 deletions) <details> <summary>View changed files</summary> 📝 `casaos-fix-docker-api-version/run.sh` (+184 -46) </details> ### 📄 Description This pull request updates the CasaOS Docker Version Fix Script to improve compatibility checks and installation robustness for Docker 24.0.x. The script now verifies Docker 24.0.x package availability for the user's OS version, installs the latest matching version rather than a hardcoded one, and provides clearer messaging and fallback logic during installation. These changes help prevent installation on unsupported OS versions and ensure users receive the most compatible Docker release for CasaOS. **Compatibility and OS Detection Improvements:** * Added the `check_docker_availability` function to detect if Docker 24.0.x is available for the user's OS version (Debian trixie, Ubuntu noble/oracular are now flagged as unsupported), with detailed error messages and recommended solutions. [[1]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaR85-R186) [[2]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL1074-R1167) * Updated script messaging and step order to verify Docker version availability before proceeding with other checks. [[1]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL1074-R1167) [[2]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL1087-R1180) **Installation Logic Enhancements:** * Changed version variables to use a pattern (`5:24.0.*`) for installing the latest available Docker 24.0.x, and updated installation commands and fallback logic to match any suitable 24.0.x version. [[1]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL37-R40) [[2]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL746-L751) [[3]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL769-R897) * Improved fallback handling for `containerd.io` installation, trying version patterns if exact matches fail, and clarified error messaging for failed installations. **Messaging and Documentation Updates:** * Updated all user-facing messages, instructions, and version references to refer to "Docker 24.0.x" instead of the specific "24.0.7" version, reflecting the more flexible installation logic. [[1]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL23-R23) [[2]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL251-R353) [[3]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL1235-R1328) [[4]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL1249-R1342) [[5]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL1267-R1360) [[6]](diffhunk://#diff-198701c5a479170ce972c97f3fc3fffdb839d314cdf1e68849f24463f63756aaL1278-R1371) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
saavagebueno added the pull-request label 2025-11-20 04:14:30 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/big-bear-scripts#73