Skip to content

feat(server): add Debian 13 (Trixie) support for server validation#8437

Closed
matiasmagni wants to merge 2 commits intocoollabsio:v4.xfrom
matiasmagni:feature/8154-debian-13-support-clean
Closed

feat(server): add Debian 13 (Trixie) support for server validation#8437
matiasmagni wants to merge 2 commits intocoollabsio:v4.xfrom
matiasmagni:feature/8154-debian-13-support-clean

Conversation

@matiasmagni
Copy link
Copy Markdown

Changes

  • Server OS validation (app/Models/Server.php): Added Debian 13 (Trixie) support by including trixie in the list of recognized Debian version codenames. When /etc/os-release has an empty or missing ID but VERSION_CODENAME is a known Debian codename (stretch, buster, bullseye, bookworm, trixie), ID is set to debian so the server is accepted. Tightened parsing of /etc/os-release (skip empty/invalid lines) and made validateOS() return the matching SUPPORTED_OS string consistently.
  • InstallPrerequisites: No change to Debian commands; existing apt flow works for Trixie. Added an explicit branch for Alpine Linux with a clear error message instead of the generic "Unsupported OS type."
  • InstallDocker: Documented in getDebianDockerInstallCommand() that the fallback uses VERSION_CODENAME (e.g. trixie) for the Docker APT suite so all Debian versions, including 13, are supported.
  • Tests: Added tests/Unit/ServerValidateOsSupportTest.php asserting that SUPPORTED_OS includes the debian family and that the Debian codename list used in validateOS() includes trixie and bookworm.

Issues

Category

  • Bug fix
  • New feature
  • Adding new one click service
  • Fixing or updating existing one click service

Screenshots or Video (if applicable)

N/A – backend validation only. Optional: screen recording of adding a Debian 13 server and running "Install Prerequisites" / Docker install without "Unsupported OS type" error.

AI Usage

  • AI is used in the process of creating this PR
  • AI is NOT used in the process of creating this PR

Steps to Test

  • Step 1 – Run unit tests: ./vendor/bin/pest tests/Unit/ServerValidateOsSupportTest.php. Expect 2 tests, 4 assertions, all passing.
  • Step 2 – (Optional, requires a Debian 13 server.) Add a new server in Coolify with SSH access to a host running Debian 13 (Trixie). Confirm the server is detected (no "Server OS type is not supported" during validation).
  • Step 3 – On that server, run Install Prerequisites from the server page. Expect success and "Prerequisites installed successfully" (no "Unsupported OS type for prerequisites installation").
  • Step 4 – On that server, run Docker installation if not already installed. Expect Docker to install using the Debian path (e.g. deb [arch=...] https://download.docker.com/linux/debian trixie stable).

Contributor Agreement

Important

  • I have read and understood the contributor guidelines. If I have failed to follow any guideline, I understand that this PR may be closed without review.
  • I have tested the changes thoroughly and am confident that they will work as expected without issues when the maintainer tests them

- Extend Server::validateOS() to recognize Debian 13 by adding 'trixie' to
  the Debian version codename list (stretch, buster, bullseye, bookworm, trixie).
  When /etc/os-release has an empty or missing ID but VERSION_CODENAME is a
  known Debian codename, ID is set to 'debian' so the server is accepted.

- InstallPrerequisites: Added explicit Alpine Linux branch with clear error
  message instead of generic 'Unsupported OS type'.

- InstallDocker: Documented that the Debian fallback uses VERSION_CODENAME
  (e.g. trixie for Debian 13) for the Docker APT suite, so all Debian
  versions are supported.

- Add ServerValidateOsSupportTest to assert SUPPORTED_OS includes the debian
  family and that the Debian codename list includes trixie (and bookworm).

Fixes coollabsio#8154
- Added patterns for various temporary files, cache directories, and system-specific files to improve project cleanliness and prevent unnecessary files from being tracked.
@github-actions
Copy link
Copy Markdown
Contributor

This PR did not pass quality checks so it will be closed. If you believe this is a mistake please let us know.

@github-actions github-actions bot closed this Feb 18, 2026
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Mar 21, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Enhancement]: Add additional server support for Debian 13

1 participant