An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.
PHP coolifydatabasesdeploymentdockerdocker-composeinertiajslaravelmariadbmysqlnextjsnodejsphppostgresredisself-hostedself-hostingserverstatic-sitesveltesvelte5
feat(server): support Alpine package management and Docker setup
Andras Bacsai96790e653190
diff --git a/app/Actions/Server/InstallDocker.php b/app/Actions/Server/InstallDocker.phpindex f4c5bdf6a5..552445d728 100644--- a/app/Actions/Server/InstallDocker.php+++ b/app/Actions/Server/InstallDocker.php@@ -95,9 +95,8 @@ class InstallDocker"jq -s '.[0] * .[1]' /etc/docker/daemon.json.coolify /etc/docker/daemon.json | tee /etc/docker/daemon.json.appended > /dev/null",'mv /etc/docker/daemon.json.appended /etc/docker/daemon.json',"echo 'Restarting Docker Engine...'",- 'systemctl enable docker >/dev/null 2>&1 || true',- 'systemctl restart docker',]);+ $command = $command->merge($this->getDockerServiceCommands($supported_os_type->contains('alpine')));if ($server->isSwarm()) {$command = $command->merge(['docker network create --attachable --driver overlay coolify-overlay >/dev/null 2>&1 || true',@@ -159,10 +158,23 @@ class InstallDockerprivate function getAlpineDockerInstallCommand(): string{return 'apk update && '.- 'apk add docker docker-cli-compose && '.- 'mkdir -p /etc/docker && '.- 'rc-update add docker default && '.- 'service docker start';+ 'apk add docker docker-cli-buildx docker-cli-compose && '.+ 'mkdir -p /etc/docker';+ }++ private function getDockerServiceCommands(bool $usesOpenRc): array+ {+ if ($usesOpenRc) {+ return [+ 'rc-update add docker default',+ 'rc-service docker restart',+ ];+ }++ return [+ 'systemctl enable docker >/dev/null 2>&1 || true',+ 'systemctl restart docker',+ ];}private function getGenericDockerInstallCommand(): stringdiff --git a/app/Actions/Server/InstallPrerequisites.php b/app/Actions/Server/InstallPrerequisites.phpindex ffb8f1208e..57fd4f1d7c 100644--- a/app/Actions/Server/InstallPrerequisites.php+++ b/app/Actions/Server/InstallPrerequisites.php@@ -54,16 +54,7 @@ class InstallPrerequisites'pacman -Syu --noconfirm --needed curl wget git jq',]);} elseif ($supported_os_type->contains('alpine')) {- // The community repository holds docker and is commented out on some Alpine images- $command = $command->merge([- "echo 'Installing Prerequisites for Alpine Linux...'",- "sed -i '/^#.*\\/community/s/^#//' /etc/apk/repositories 2>/dev/null || true",- 'apk update',- 'command -v curl >/dev/null || apk add curl',- 'command -v wget >/dev/null || apk add wget',- 'command -v git >/dev/null || apk add git',- 'command -v jq >/dev/null || apk add jq',- ]);+ $command = $command->merge($this->getAlpinePrerequisiteCommands());} else {throw new \Exception('Unsupported OS type for prerequisites installation');}@@ -72,4 +63,18 @@ class InstallPrerequisitesreturn remote_process($command, $server);}++ private function getAlpinePrerequisiteCommands(): array+ {+ return [+ "echo 'Installing Prerequisites for Alpine Linux...'",+ "sed -i '/^#.*\\/community/s/^#//' /etc/apk/repositories 2>/dev/null || true",+ 'apk update',+ 'command -v bash >/dev/null || apk add bash',+ 'command -v curl >/dev/null || apk add curl',+ 'command -v wget >/dev/null || apk add wget',+ 'command -v git >/dev/null || apk add git',+ 'command -v jq >/dev/null || apk add jq',+ ];+ }}diff --git a/app/Actions/Server/UpdatePackage.php b/app/Actions/Server/UpdatePackage.phpindex d77d5b87ee..2b06e06011 100644--- a/app/Actions/Server/UpdatePackage.php+++ b/app/Actions/Server/UpdatePackage.php@@ -60,7 +60,7 @@ class UpdatePackagebreak;case 'apk':$commandAll = 'apk update && apk upgrade';- $commandInstall = 'apk upgrade '.$package;+ $commandInstall = 'apk upgrade '.$sanitizedPackage;break;default:return [diff --git a/app/Helpers/SshMultiplexingHelper.php b/app/Helpers/SshMultiplexingHelper.phpindex 1a9b688f40..137f50fbbd 100644--- a/app/Helpers/SshMultiplexingHelper.php+++ b/app/Helpers/SshMultiplexingHelper.php@@ -210,12 +210,18 @@ class SshMultiplexingHelper$delimiter = base64_encode(Hash::make($command));$command = str_replace($delimiter, '', $command);+ $remoteShellCommand = self::remoteShellCommand();- return $sshCommand.self::escapedUserAtHost($server)." 'bash -se' << \\$delimiter".PHP_EOL+ return $sshCommand.self::escapedUserAtHost($server)." '{$remoteShellCommand}' << \\$delimiter".PHP_EOL.$command.PHP_EOL.$delimiter;}+ private static function remoteShellCommand(): string+ {+ return 'if command -v bash >/dev/null 2>&1; then exec bash -se; else exec sh -se; fi';+ }+public static function getConnectionTimeout(Server $server): int{$timeout = data_get($server, 'settings.connection_timeout');diff --git a/resources/views/livewire/server/security/patches.blade.php b/resources/views/livewire/server/security/patches.blade.phpindex 07a7964cbe..0c1f28fd41 100644--- a/resources/views/livewire/server/security/patches.blade.php+++ b/resources/views/livewire/server/security/patches.blade.php@@ -35,7 +35,7 @@</x-slot:actions><x-callout type="info" title="Supported package managers">- Automated package discovery currently supports apk, apt, dnf, and zypper. Weekly status+ Automated package discovery currently supports apk, apt, dnf, pacman, and zypper. Weekly statusnotifications can be managed from<a class="font-medium underline" href="{{ route('notifications.email') }}"{{ wireNavigate() }}>notification settings</a>.diff --git a/tests/Feature/SshMultiplexingLockTest.php b/tests/Feature/SshMultiplexingLockTest.phpindex f06e50c1a9..a52b382028 100644--- a/tests/Feature/SshMultiplexingLockTest.php+++ b/tests/Feature/SshMultiplexingLockTest.php@@ -156,7 +156,7 @@ it('adds mux options to ssh commands only after the explicit master is ready', f->toContain('-o ControlMaster=auto')->toContain("-o ControlPath=/var/www/html/storage/app/ssh/mux/mux_{$server->uuid}")->toContain('-o ControlPersist=3600')- ->toContain("'bash -se' << \\")+ ->toContain("'if command -v bash >/dev/null 2>&1; then exec bash -se; else exec sh -se; fi' << \\")->not->toContain('<< $delimiter');Process::assertRan(fn ($process) => str_contains($process->command, 'ssh -fN '));diff --git a/tests/Unit/Actions/Server/AlpinePackageManagerTest.php b/tests/Unit/Actions/Server/AlpinePackageManagerTest.phpnew file mode 100644index 0000000000..d8050c84d9--- /dev/null+++ b/tests/Unit/Actions/Server/AlpinePackageManagerTest.php@@ -0,0 +1,62 @@+<?php++use App\Actions\Server\CheckUpdates;+use App\Actions\Server\InstallDocker;+use App\Actions\Server\InstallPrerequisites;++it('installs Bash while bootstrapping Alpine prerequisites', function () {+ $method = new ReflectionMethod(InstallPrerequisites::class, 'getAlpinePrerequisiteCommands');++ $commands = $method->invoke(new InstallPrerequisites);++ expect($commands)->toContain('command -v bash >/dev/null || apk add bash');+});++it('installs every Docker CLI plugin required on Alpine', function () {+ $method = new ReflectionMethod(InstallDocker::class, 'getAlpineDockerInstallCommand');++ $command = $method->invoke(new InstallDocker);++ expect($command)->toContain('apk add docker docker-cli-buildx docker-cli-compose');+});++it('uses OpenRC instead of systemd to restart Docker on Alpine', function () {+ $method = new ReflectionMethod(InstallDocker::class, 'getDockerServiceCommands');++ $action = new InstallDocker;+ $commands = $method->invoke($action, true);++ expect($commands)+ ->toBe(['rc-update add docker default', 'rc-service docker restart'])+ ->each->not->toContain('systemctl')+ ->and($method->invoke($action, false))+ ->toBe(['systemctl enable docker >/dev/null 2>&1 || true', 'systemctl restart docker']);+});++it('parses Alpine package updates', function () {+ $method = new ReflectionMethod(CheckUpdates::class, 'parseApkOutput');+ $output = <<<'OUTPUT'+docker-cli-compose-2.31.0-r5 x86_64 {docker-cli-compose} (Apache-2.0) [upgradable from: docker-cli-compose-2.31.0-r4]+libcrypto3-3.3.4-r0 aarch64 {openssl} (Apache-2.0) [upgradable from: libcrypto3-3.3.3-r0]+OUTPUT;++ $result = $method->invoke(new CheckUpdates, $output);++ expect($result)->toBe([+ 'total_updates' => 2,+ 'updates' => [+ [+ 'package' => 'docker-cli-compose',+ 'new_version' => '2.31.0-r5',+ 'architecture' => 'x86_64',+ 'current_version' => '2.31.0-r4',+ ],+ [+ 'package' => 'libcrypto3',+ 'new_version' => '3.3.4-r0',+ 'architecture' => 'aarch64',+ 'current_version' => '3.3.3-r0',+ ],+ ],+ ]);+});diff --git a/tests/Unit/SshMultiplexingDisableTest.php b/tests/Unit/SshMultiplexingDisableTest.phpindex d2d4ae600f..4dedc7a768 100644--- a/tests/Unit/SshMultiplexingDisableTest.php+++ b/tests/Unit/SshMultiplexingDisableTest.php@@ -23,6 +23,16 @@ class SshMultiplexingDisableTest extends TestCase);}+ public function test_remote_shell_prefers_bash_and_falls_back_to_sh()+ {+ $reflection = new \ReflectionMethod(SshMultiplexingHelper::class, 'remoteShellCommand');++ $this->assertSame(+ 'if command -v bash >/dev/null 2>&1; then exec bash -se; else exec sh -se; fi',+ $reflection->invoke(null)+ );+ }+public function test_generate_ssh_command_accepts_disable_multiplexing_parameter(){$reflection = new \ReflectionMethod(SshMultiplexingHelper::class, 'generateSshCommand');