Skip to content

fix(compatibility): require Unraid 6.12 and remove legacy WebUI patches - #173

Merged
mstrhakr merged 1 commit into
devfrom
mstrhakr/issue170
Oct 8, 2026
Merged

mstrhakr merged 1 commit into
devfrom
mstrhakr/issue170

Conversation

@mstrhakr

@mstrhakr mstrhakr commented Oct 8, 2026 •

Copy link
Copy Markdown
Owner

This pull request removes support for Unraid versions earlier than 6.12.0, simplifying the codebase and documentation by eliminating legacy patching logic and UI elements related to older Unraid releases. All references to the legacy "Patch Web UI" feature and compatibility code for pre-6.12 Unraid have been removed, reflecting the new minimum version requirement of Unraid 6.12.0 (which includes PHP 8). Documentation has also been updated to clarify the new requirements and streamline user instructions.

Minimum version and requirements update:

  • Updated the minimum required Unraid version to 6.12.0 (with PHP 8) in README.md, docs/getting-started.md, and compose.manager.plg. [1] [2] [3]

Removal of legacy patching support:

  • Removed all plugin installation and removal logic for UI patches targeting pre-6.12 Unraid versions from compose.manager.plg. [1] [2]
  • Deleted the PATCH_UI setting and associated code, UI elements, and AJAX handlers from source/compose.manager/compose.manager.settings.page and default.cfg. [1] [2] [3] [4] [5] [6] [7] [8]
  • Removed the runPatch AJAX handler from source/compose.manager/include/Exec.php.

Documentation updates and simplification:

  • Updated all documentation (docs/configuration.md, docs/user-guide.md) to remove references to the legacy patch feature, clarify the new behavior for hiding Compose containers, and explain that no patching is needed on Unraid 6.12+. [1] [2] [3] [4] [5]

These changes ensure Compose Manager is streamlined for Unraid 6.12.0 and later, reducing maintenance and potential confusion for users.

Fixes #170

Align documented requirements with the plugin's PHP 8 dependency. Remove obsolete patch scripts, assets, installer hooks, settings and action handling, while retaining the pre-7.0 Ace fallback and Git patch features.

Add installer compatibility regression coverage for the minimum version and Ace fallback. Fixes #170.
Copilot AI balanced review requested due to automatic review settings October 8, 2026 13:30

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The compatibility requirement and legacy removals are consistent, with no unresolved blocking findings.

0 open findings

What changed in this PR

Raises Compose Manager’s minimum supported Unraid version to 6.12.0 and removes obsolete WebUI patching support.

Changes:

  • Updates installer requirements and documentation.
  • Removes legacy patches, scripts, settings, and handlers.
  • Adds installer compatibility tests while retaining the Ace fallback.
File Description
tests/​unit/​patch.bats Removes obsolete patch-helper tests.
tests/​unit/​InstallerCompatibilityTest.php Tests minimum version and retained Ace fallback.
tests/​unit/​ComposeFilterTest.php Updates a filtering comment only.
source/​pkg_build.sh Updates package description wording.
source/​compose.manager/​scripts/​patch.sh Deletes legacy patch utility.
source/​compose.manager/​scripts/​install-patch.sh Deletes patch lifecycle script.
source/​compose.manager/​patches/​6.9/​docker_client.patch Deletes Unraid 6.9 patch.
source/​compose.manager/​patches/​6.11/​docker_client.patch Deletes Unraid 6.11 patch.
source/​compose.manager/​patches/​6.10/​docker_client.patch Deletes Unraid 6.10 patch.
source/​compose.manager/​include/​Exec.php Removes patch execution handler.
source/​compose.manager/​default.cfg Removes patch setting default.
source/​compose.manager/​compose.manager.settings.page Removes patch controls and supporting logic.
README.md Documents the new minimum version.
docs/​user-guide.md Clarifies filtering and removes patch instructions.
docs/​getting-started.md Updates installation requirements.
docs/​configuration.md Removes legacy patch documentation.
compose.manager.plg Enforces minimum version and removes patch hooks.

🧠 Review effort: Balanced


Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.

@mstrhakr
mstrhakr merged commit 9f846a1 into dev Oct 8, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants