/claim #8154

Summary

This PR addresses Debian 13 server support and adds Alpine Linux support to the prerequisites and Docker installation flow.

Investigation Findings

Debian 13 Support Analysis

After thorough code analysis, I verified that Debian 13 (trixie) is already supported by the current codebase:

1. OS Detection (Server.php:validateOS()):

   • Debian 13’s /etc/os-release contains ID=debian
   • SUPPORTED_OS constant includes 'ubuntu debian raspbian pop' which matches “debian”
   • Returns 'ubuntu debian raspbian pop' which passes the contains('debian') check

2. Docker Installation (InstallDocker.php):

   • PR #7012 already added the three-tier fallback mechanism
   • Uses ${VERSION_CODENAME} (trixie for Debian 13) for direct APT repository setup
   • Fallback chain: Rancher script → get.docker.com → Direct APT

3. Prerequisites (InstallPrerequisites.php):

   • Debian handler uses standard apt-get commands that work on all Debian versions

Bug Found: Alpine Linux Missing

While investigating, I discovered that Alpine Linux is listed in SUPPORTED_OS but has no handler in:

• InstallPrerequisites.php - Would throw “Unsupported OS type” exception
• InstallDocker.php - Would fall through to generic installer (less optimal)

Changes Made

1. InstallPrerequisites.php

• Added Alpine Linux support using apk package manager
• Improved error message to include detected OS type for debugging

} elseif ($supported_os_type->contains('alpine')) {
    $command = $command->merge([
        "echo 'Installing Prerequisites for Alpine Linux...'",
        'apk update',
        'apk add --no-cache curl wget git jq',
    ]);
}

2. InstallDocker.php

• Added Alpine Linux Docker installation using apk
• Added OpenRC support (Alpine uses rc-update/service instead of systemctl)

private function getAlpineDockerInstallCommand(): string
{
    return 'apk update && apk add --no-cache docker docker-cli-compose';
}

Testing

Debian 13 Verification

$ docker run --rm debian:trixie cat /etc/os-release
PRETTY_NAME="Debian GNU/Linux 13 (trixie)"
VERSION_ID="13"
VERSION_CODENAME=trixie
ID=debian  # ✅ Correctly identified

Alpine Prerequisites Test

$ docker run --rm alpine:latest sh -c "apk update && apk add --no-cache curl wget git jq"
# ✅ Successfully installs all prerequisites

How to Test

1. Debian 13: Connect a Debian 13 server to Coolify and verify:

   • OS validation passes
   • Prerequisites install successfully
   • Docker installs successfully

2. Alpine Linux: Connect an Alpine server to Coolify and verify same flow

Demo Video

📹 Demo video will be added showing Debian 13 server successfully connecting to Coolify.

Files Changed

Fixes #8154