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): add configurable SSH connection timeout per server
Andras Bacsai6293b14586b1
diff --git a/app/Helpers/SshMultiplexingHelper.php b/app/Helpers/SshMultiplexingHelper.phpindex aa9d06996d..4629df571d 100644--- a/app/Helpers/SshMultiplexingHelper.php+++ b/app/Helpers/SshMultiplexingHelper.php@@ -71,7 +71,7 @@ class SshMultiplexingHelper$sshConfig = self::serverSshConfiguration($server);$sshKeyLocation = $sshConfig['sshKeyLocation'];$muxSocket = $sshConfig['muxFilename'];- $connectionTimeout = config('constants.ssh.connection_timeout');+ $connectionTimeout = self::getConnectionTimeout($server);$serverInterval = config('constants.ssh.server_interval');$muxPersistTime = config('constants.ssh.mux_persist_time');@@ -140,7 +140,7 @@ class SshMultiplexingHelper$scp_command .= '-o ProxyCommand="cloudflared access ssh --hostname %h" ';}- $scp_command .= self::getCommonSshOptions($server, $sshKeyLocation, config('constants.ssh.connection_timeout'), config('constants.ssh.server_interval'), isScp: true);+ $scp_command .= self::getCommonSshOptions($server, $sshKeyLocation, self::getConnectionTimeout($server), config('constants.ssh.server_interval'), isScp: true);if ($server->isIpv6()) {$scp_command .= "{$source} ".escapeshellarg($server->user).'@['.escapeshellarg($server->ip)."]:{$dest}";} else {@@ -184,7 +184,7 @@ class SshMultiplexingHelper$ssh_command .= "-o ProxyCommand='cloudflared access ssh --hostname %h' ";}- $ssh_command .= self::getCommonSshOptions($server, $sshKeyLocation, config('constants.ssh.connection_timeout'), config('constants.ssh.server_interval'));+ $ssh_command .= self::getCommonSshOptions($server, $sshKeyLocation, self::getConnectionTimeout($server), config('constants.ssh.server_interval'));$delimiter = Hash::make($command);$delimiter = base64_encode($delimiter);@@ -243,6 +243,15 @@ class SshMultiplexingHelper}}+ public static function getConnectionTimeout(Server $server): int+ {+ $timeout = data_get($server, 'settings.connection_timeout');++ return is_numeric($timeout) && (int) $timeout > 0+ ? (int) $timeout+ : (int) config('constants.ssh.connection_timeout');+ }+private static function getCommonSshOptions(Server $server, string $sshKeyLocation, int $connectionTimeout, int $serverInterval, bool $isScp = false): string{$options = "-i {$sshKeyLocation} "diff --git a/app/Livewire/Server/Show.php b/app/Livewire/Server/Show.phpindex 84cb65ee6a..3e05d9306c 100644--- a/app/Livewire/Server/Show.php+++ b/app/Livewire/Server/Show.php@@ -32,6 +32,8 @@ class Show extends Componentpublic string $port;+ public int $connectionTimeout;+public ?string $validationLogs = null;public ?string $wildcardDomain = null;@@ -110,6 +112,7 @@ class Show extends Component'ip' => ['required', new ValidServerIp],'user' => ['required', 'regex:/^[a-zA-Z0-9_-]+$/'],'port' => 'required|integer|between:1,65535',+ 'connectionTimeout' => 'required|integer|min:1|max:300','validationLogs' => 'nullable','wildcardDomain' => 'nullable|url','isReachable' => 'required',@@ -138,6 +141,10 @@ class Show extends Component'ip.required' => 'The IP Address field is required.','user.required' => 'The User field is required.','port.required' => 'The Port field is required.',+ 'connectionTimeout.required' => 'The SSH Connection Timeout field is required.',+ 'connectionTimeout.integer' => 'The SSH Connection Timeout must be an integer.',+ 'connectionTimeout.min' => 'The SSH Connection Timeout must be at least 1 second.',+ 'connectionTimeout.max' => 'The SSH Connection Timeout must not exceed 300 seconds.','wildcardDomain.url' => 'The Wildcard Domain must be a valid URL.','sentinelToken.required' => 'The Sentinel Token field is required.','sentinelMetricsRefreshRateSeconds.required' => 'The Metrics Refresh Rate field is required.',@@ -210,6 +217,7 @@ class Show extends Component$this->server->validation_logs = $this->validationLogs;$this->server->save();+ $this->server->settings->connection_timeout = $this->connectionTimeout;$this->server->settings->is_swarm_manager = $this->isSwarmManager;$this->server->settings->wildcard_domain = $this->wildcardDomain;$this->server->settings->is_swarm_worker = $this->isSwarmWorker;@@ -237,6 +245,7 @@ class Show extends Component$this->ip = $this->server->ip;$this->user = $this->server->user;$this->port = $this->server->port;+ $this->connectionTimeout = $this->server->settings->connection_timeout;$this->wildcardDomain = $this->server->settings->wildcard_domain;$this->isReachable = $this->server->settings->is_reachable;@@ -407,7 +416,7 @@ class Show extends Componentreturn;}- $hetznerService = new \App\Services\HetznerService($this->server->cloudProviderToken->token);+ $hetznerService = new HetznerService($this->server->cloudProviderToken->token);$serverData = $hetznerService->getServer($this->server->hetzner_server_id);$this->hetznerServerStatus = $serverData['status'] ?? null;@@ -471,7 +480,7 @@ class Show extends Componentreturn;}- $hetznerService = new \App\Services\HetznerService($this->server->cloudProviderToken->token);+ $hetznerService = new HetznerService($this->server->cloudProviderToken->token);$hetznerService->powerOnServer($this->server->hetzner_server_id);$this->hetznerServerStatus = 'starting';diff --git a/app/Models/ServerSetting.php b/app/Models/ServerSetting.phpindex 30fc1e1651..8d85c89320 100644--- a/app/Models/ServerSetting.php+++ b/app/Models/ServerSetting.php@@ -49,6 +49,7 @@ use OpenApi\Attributes as OA;'updated_at' => ['type' => 'string'],'delete_unused_volumes' => ['type' => 'boolean', 'description' => 'The flag to indicate if the unused volumes should be deleted.'],'delete_unused_networks' => ['type' => 'boolean', 'description' => 'The flag to indicate if the unused networks should be deleted.'],+ 'connection_timeout' => ['type' => 'integer', 'description' => 'SSH connection timeout in seconds.'],])]class ServerSetting extends Model@@ -97,6 +98,7 @@ class ServerSetting extends Model'is_terminal_enabled','deployment_queue_limit','disable_application_image_retention',+ 'connection_timeout',];protected $casts = [@@ -108,6 +110,7 @@ class ServerSetting extends Model'is_usable' => 'boolean','is_terminal_enabled' => 'boolean','disable_application_image_retention' => 'boolean',+ 'connection_timeout' => 'integer',];protected static function booted()diff --git a/database/migrations/2026_04_28_151408_add_connection_timeout_to_server_settings.php b/database/migrations/2026_04_28_151408_add_connection_timeout_to_server_settings.phpnew file mode 100644index 0000000000..1700feebcb--- /dev/null+++ b/database/migrations/2026_04_28_151408_add_connection_timeout_to_server_settings.php@@ -0,0 +1,22 @@+<?php++use Illuminate\Database\Migrations\Migration;+use Illuminate\Database\Schema\Blueprint;+use Illuminate\Support\Facades\Schema;++return new class extends Migration+{+ public function up(): void+ {+ Schema::table('server_settings', function (Blueprint $table) {+ $table->integer('connection_timeout')->default(10)->after('deployment_queue_limit');+ });+ }++ public function down(): void+ {+ Schema::table('server_settings', function (Blueprint $table) {+ $table->dropColumn('connection_timeout');+ });+ }+};diff --git a/openapi.json b/openapi.jsonindex 09232be2fd..8b3d5b91fc 100644--- a/openapi.json+++ b/openapi.json@@ -13349,6 +13349,10 @@"delete_unused_networks": {"type": "boolean","description": "The flag to indicate if the unused networks should be deleted."+ },+ "connection_timeout": {+ "type": "integer",+ "description": "SSH connection timeout in seconds."}},"type": "object"diff --git a/openapi.yaml b/openapi.yamlindex d6a8d76356..07d9b60956 100644--- a/openapi.yaml+++ b/openapi.yaml@@ -8538,6 +8538,9 @@ components:delete_unused_networks:type: booleandescription: 'The flag to indicate if the unused networks should be deleted.'+ connection_timeout:+ type: integer+ description: 'SSH connection timeout in seconds.'type: objectService:description: 'Service model'diff --git a/resources/views/livewire/server/show.blade.php b/resources/views/livewire/server/show.blade.phpindex d694174d54..cfbeccd0c0 100644--- a/resources/views/livewire/server/show.blade.php+++ b/resources/views/livewire/server/show.blade.php@@ -191,6 +191,12 @@label="Port" required :disabled="$isValidating" /></div></div>+ <div class="w-full lg:w-64">+ <x-forms.input canGate="update" :canResource="$server" type="number"+ id="connectionTimeout" label="SSH Connection Timeout (s)"+ helper="Seconds to wait for SSH connection before failing. Default: 10."+ min="1" max="300" required :disabled="$isValidating" />+ </div><div class="w-full"><div class="flex items-center mb-1"><label for="serverTimezone">Server Timezone</label>diff --git a/tests/Feature/ServerConnectionTimeoutTest.php b/tests/Feature/ServerConnectionTimeoutTest.phpnew file mode 100644index 0000000000..b457f3f017--- /dev/null+++ b/tests/Feature/ServerConnectionTimeoutTest.php@@ -0,0 +1,43 @@+<?php++use App\Helpers\SshMultiplexingHelper;+use App\Models\Server;+use App\Models\User;+use Illuminate\Foundation\Testing\RefreshDatabase;++uses(RefreshDatabase::class);++beforeEach(function () {+ $user = User::factory()->create();+ $this->team = $user->teams()->first();+ $this->server = Server::factory()->create([+ 'team_id' => $this->team->id,+ ]);+});++it('defaults connection_timeout to 10 seconds for new servers', function () {+ expect($this->server->settings->connection_timeout)->toBe(10);+});++it('persists a custom connection_timeout value', function () {+ $this->server->settings->connection_timeout = 30;+ $this->server->settings->save();++ expect($this->server->settings->fresh()->connection_timeout)->toBe(30);+});++it('returns the per-server connection_timeout from getConnectionTimeout', function () {+ $this->server->settings->connection_timeout = 45;+ $this->server->settings->save();++ expect(SshMultiplexingHelper::getConnectionTimeout($this->server->fresh()))->toBe(45);+});++it('falls back to config default when connection_timeout is invalid', function () {+ $this->server->settings->connection_timeout = 0;+ $this->server->settings->saveQuietly();++ $expected = (int) config('constants.ssh.connection_timeout');++ expect(SshMultiplexingHelper::getConnectionTimeout($this->server->fresh()))->toBe($expected);+});