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(hetzner): add support for enabling backups during server creation
Jan Thiel6637159d7bd8
diff --git a/app/Http/Controllers/Api/HetznerController.php b/app/Http/Controllers/Api/HetznerController.phpindex 55bd4197f7..d729bca541 100644--- a/app/Http/Controllers/Api/HetznerController.php+++ b/app/Http/Controllers/Api/HetznerController.php@@ -2,6 +2,7 @@namespace App\Http\Controllers\Api;+use App\Actions\Server\ValidateServer;use App\Enums\ProxyTypes;use App\Exceptions\RateLimitException;use App\Http\Controllers\Controller;@@ -12,6 +13,7 @@ use App\Models\Team;use App\Rules\ValidCloudInitYaml;use App\Rules\ValidHostname;use App\Services\HetznerService;+use Illuminate\Http\JsonResponse;use Illuminate\Http\Request;use OpenApi\Attributes as OA;@@ -668,6 +670,7 @@ class HetznerController extends Controller'private_key_uuid' => ['type' => 'string', 'example' => 'xyz789', 'description' => 'Private key UUID'],'enable_ipv4' => ['type' => 'boolean', 'example' => true, 'description' => 'Enable IPv4 (default: true)'],'enable_ipv6' => ['type' => 'boolean', 'example' => true, 'description' => 'Enable IPv6 (default: true)'],+ 'enable_backups' => ['type' => 'boolean', 'example' => false, 'description' => 'Enable Hetzner server backups after creation (adds 20% to the monthly server fee)'],'hetzner_ssh_key_ids' => ['type' => 'array', 'items' => ['type' => 'integer'], 'description' => 'Additional Hetzner SSH key IDs'],'hetzner_firewall_ids' => ['type' => 'array', 'items' => ['type' => 'integer'], 'description' => 'Existing Hetzner firewall IDs to apply during server creation'],'hetzner_network_ids' => ['type' => 'array', 'items' => ['type' => 'integer'], 'description' => 'Existing Hetzner network IDs to attach during server creation'],@@ -728,6 +731,7 @@ class HetznerController extends Controller'private_key_uuid','enable_ipv4','enable_ipv6',+ 'enable_backups','hetzner_ssh_key_ids','hetzner_firewall_ids','hetzner_network_ids',@@ -741,7 +745,7 @@ class HetznerController extends Controller}$return = validateIncomingRequest($request);- if ($return instanceof \Illuminate\Http\JsonResponse) {+ if ($return instanceof JsonResponse) {return $return;}@@ -755,6 +759,7 @@ class HetznerController extends Controller'private_key_uuid' => 'required|string','enable_ipv4' => 'nullable|boolean','enable_ipv6' => 'nullable|boolean',+ 'enable_backups' => 'nullable|boolean','hetzner_ssh_key_ids' => 'nullable|array','hetzner_ssh_key_ids.*' => 'integer','hetzner_firewall_ids' => 'nullable|array',@@ -796,6 +801,9 @@ class HetznerController extends Controllerif (is_null($request->enable_ipv6)) {$request->offsetSet('enable_ipv6', true);}+ if (is_null($request->enable_backups)) {+ $request->offsetSet('enable_backups', false);+ }if (is_null($request->hetzner_ssh_key_ids)) {$request->offsetSet('hetzner_ssh_key_ids', []);}@@ -900,6 +908,10 @@ class HetznerController extends Controller// Create server on Hetzner$hetznerServer = $hetznerService->createServer($params);+ if ($request->enable_backups) {+ $hetznerService->enableServerBackup((int) $hetznerServer['id']);+ }+// Determine IP address to use (prefer IPv4, fallback to IPv6)$ipAddress = null;if ($request->enable_ipv4 && isset($hetznerServer['public_net']['ipv4']['ip'])) {@@ -930,7 +942,7 @@ class HetznerController extends Controller// Validate server if requestedif ($request->instant_validate) {- \App\Actions\Server\ValidateServer::dispatch($server);+ ValidateServer::dispatch($server);}return response()->json([diff --git a/app/Livewire/Server/New/ByHetzner.php b/app/Livewire/Server/New/ByHetzner.phpindex 8fb12e7144..9b021b2c3d 100644--- a/app/Livewire/Server/New/ByHetzner.php+++ b/app/Livewire/Server/New/ByHetzner.php@@ -72,6 +72,8 @@ class ByHetzner extends Componentpublic bool $enable_ipv6 = true;+ public bool $enable_backups = false;+public ?string $cloud_init_script = null;public bool $save_cloud_init_script = false;@@ -116,6 +118,7 @@ class ByHetzner extends Component{$this->selected_token_id = null;$this->current_step = 1;+ $this->enable_backups = false;$this->cloud_init_script = null;$this->save_cloud_init_script = false;$this->cloud_init_script_name = null;@@ -177,6 +180,7 @@ class ByHetzner extends Component'selectedHetznerNetworkIds.*' => 'integer','enable_ipv4' => 'required|boolean','enable_ipv6' => 'required|boolean',+ 'enable_backups' => 'required|boolean','cloud_init_script' => ['nullable', 'string', new ValidCloudInitYaml],'save_cloud_init_script' => 'boolean','cloud_init_script_name' => 'nullable|string|max:255',@@ -419,6 +423,23 @@ class ByHetzner extends Componentreturn '€'.number_format($price, 2);}+ public function getSelectedServerBackupSurchargeProperty(): ?string+ {+ if (! $this->selected_server_type) {+ return null;+ }++ $serverType = collect($this->serverTypes)->firstWhere('name', $this->selected_server_type);++ if (! $serverType || ! isset($serverType['prices'][0]['price_monthly']['gross'])) {+ return null;+ }++ $price = (float) $serverType['prices'][0]['price_monthly']['gross'];++ return '€'.number_format($price * 0.2, 2);+ }+public function updatedSelectedLocation($value){// Reset server type and image when location changes@@ -461,10 +482,8 @@ class ByHetzner extends Component$this->save_cloud_init_script = false;}- private function createHetznerServer(string $token): array+ private function createHetznerServer(HetznerService $hetznerService): array{- $hetznerService = new HetznerService($token);-// Get the private key and extract public key$privateKey = PrivateKey::ownedByCurrentTeam()->findOrFail($this->private_key_id);@@ -564,9 +583,14 @@ class ByHetzner extends Component}$hetznerToken = $this->getHetznerToken();+ $hetznerService = new HetznerService($hetznerToken);// Create server on Hetzner- $hetznerServer = $this->createHetznerServer($hetznerToken);+ $hetznerServer = $this->createHetznerServer($hetznerService);++ if ($this->enable_backups) {+ $hetznerService->enableServerBackup((int) $hetznerServer['id']);+ }// Determine IP address to use (prefer IPv4, fallback to IPv6)$ipAddress = null;diff --git a/app/Services/HetznerService.php b/app/Services/HetznerService.phpindex ce6ce6497f..3deb23c333 100644--- a/app/Services/HetznerService.php+++ b/app/Services/HetznerService.php@@ -3,6 +3,7 @@namespace App\Services;use App\Exceptions\RateLimitException;+use Illuminate\Http\Client\RequestException;use Illuminate\Support\Facades\Http;class HetznerService@@ -24,7 +25,7 @@ class HetznerService->timeout(30)->retry(3, function (int $attempt, \Exception $exception) {// Handle rate limiting (429 Too Many Requests)- if ($exception instanceof \Illuminate\Http\Client\RequestException) {+ if ($exception instanceof RequestException) {$response = $exception->response;if ($response && $response->status() === 429) {@@ -153,6 +154,13 @@ class HetznerServicereturn $response['server'] ?? [];}+ public function enableServerBackup(int $serverId): array+ {+ $response = $this->request('post', "/servers/{$serverId}/actions/enable_backup");++ return $response['action'] ?? [];+ }+public function getServer(int $serverId): array{$response = $this->request('get', "/servers/{$serverId}");diff --git a/resources/views/livewire/server/new/by-hetzner.blade.php b/resources/views/livewire/server/new/by-hetzner.blade.phpindex 2efb9baebc..2a25e99589 100644--- a/resources/views/livewire/server/new/by-hetzner.blade.php+++ b/resources/views/livewire/server/new/by-hetzner.blade.php@@ -73,7 +73,7 @@@if (isset($serverType['cpu_vendor_info']) && $serverType['cpu_vendor_info'])({{ $serverType['cpu_vendor_info'] }})@endif- , {{ $serverType['memory'] }}GB RAM,+ , {{ $serverType['memory'] }}GB RAM,{{ $serverType['disk'] }}GB@if (isset($serverType['architecture']))[{{ $serverType['architecture'] }}]@@ -190,6 +190,12 @@</div></div>+ <div class="flex flex-col gap-2">+ <label class="text-sm font-medium">Backups</label>+ <x-forms.checkbox id="enable_backups" label="Enable Hetzner Backups"+ helper="Hetzner bills backups at an additional 20% of the server monthly fee{{ $this->selectedServerBackupSurcharge ? ' (about ' . $this->selectedServerBackupSurcharge . '/mo for the selected server type)' : '' }}." />+ </div>+<div class="flex flex-col gap-2"><div class="flex justify-between items-center gap-2"><label class="text-sm font-medium w-32">Cloud-Init Script</label>diff --git a/tests/Feature/HetznerApiTest.php b/tests/Feature/HetznerApiTest.phpindex c8546e36b5..e0c7e35fff 100644--- a/tests/Feature/HetznerApiTest.php+++ b/tests/Feature/HetznerApiTest.php@@ -1,6 +1,7 @@<?phpuse App\Models\CloudProviderToken;+use App\Models\InstanceSettings;use App\Models\PrivateKey;use App\Models\Team;use App\Models\User;@@ -11,6 +12,17 @@ use Illuminate\Support\Facades\Http;uses(RefreshDatabase::class);beforeEach(function () {+ config()->set('cache.default', 'array');+ config()->set('app.maintenance.driver', 'file');+ config()->set('app.maintenance.store', 'array');++ InstanceSettings::unguarded(function () {+ InstanceSettings::query()->create([+ 'id' => 0,+ 'is_registration_enabled' => true,+ ]);+ });+// Create a team with owner$this->team = Team::factory()->create();$this->user = User::factory()->create();@@ -22,15 +34,25 @@ beforeEach(function () {$this->bearerToken = $this->token->plainTextToken;// Create a Hetzner cloud provider token- $this->hetznerToken = CloudProviderToken::factory()->create([+ $this->hetznerToken = CloudProviderToken::create(['team_id' => $this->team->id,'provider' => 'hetzner',+ 'name' => 'Test Hetzner Token','token' => 'test-hetzner-api-token',]);// Create a private key- $this->privateKey = PrivateKey::factory()->create([+ $this->privateKey = PrivateKey::create(['team_id' => $this->team->id,+ 'name' => 'Test Key',+ 'description' => 'Test SSH key',+ 'private_key' => '-----BEGIN OPENSSH PRIVATE KEY-----+b3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW+QyNTUxOQAAACBbhpqHhqv6aI67Mj9abM3DVbmcfYhZAhC7ca4d9UCevAAAAJi/QySHv0Mk+hwAAAAtzc2gtZWQyNTUxOQAAACBbhpqHhqv6aI67Mj9abM3DVbmcfYhZAhC7ca4d9UCevA+AAAECBQw4jg1WRT2IGHMncCiZhURCts2s24HoDS0thHnnRKVuGmoeGq/pojrsyP1pszcNV+uZx9iFkCELtxrh31QJ68AAAAEXNhaWxANzZmZjY2ZDJlMmRkAQIDBA==+-----END OPENSSH PRIVATE KEY-----',]);});@@ -307,6 +329,64 @@ describe('POST /api/v1/servers/hetzner', function () {]);});+ test('enables backups after creating a Hetzner server when requested', function () {+ Http::fake(function (HttpRequest $request) {+ if ($request->method() === 'GET' && str_starts_with($request->url(), 'https://api.hetzner.cloud/v1/ssh_keys')) {+ return Http::response([+ 'ssh_keys' => [],+ 'meta' => ['pagination' => ['next_page' => null]],+ ], 200);+ }++ if ($request->method() === 'POST' && $request->url() === 'https://api.hetzner.cloud/v1/ssh_keys') {+ return Http::response([+ 'ssh_key' => ['id' => 123, 'fingerprint' => 'aa:bb:cc:dd'],+ ], 201);+ }++ if ($request->method() === 'POST' && $request->url() === 'https://api.hetzner.cloud/v1/servers') {+ return Http::response([+ 'server' => [+ 'id' => 456,+ 'name' => 'test-server',+ 'public_net' => [+ 'ipv4' => ['ip' => '1.2.3.4'],+ 'ipv6' => ['ip' => '2001:db8::1'],+ ],+ ],+ ], 201);+ }++ if ($request->method() === 'POST' && $request->url() === 'https://api.hetzner.cloud/v1/servers/456/actions/enable_backup') {+ return Http::response([+ 'action' => ['id' => 789, 'command' => 'enable_backup', 'status' => 'running'],+ ], 201);+ }++ return Http::response([], 404);+ });++ $response = $this->withHeaders([+ 'Authorization' => 'Bearer '.$this->bearerToken,+ 'Content-Type' => 'application/json',+ ])->postJson('/api/v1/servers/hetzner', [+ 'cloud_provider_token_id' => $this->hetznerToken->uuid,+ 'location' => 'nbg1',+ 'server_type' => 'cx11',+ 'image' => 15512617,+ 'name' => 'test-server',+ 'private_key_uuid' => $this->privateKey->uuid,+ 'enable_ipv4' => true,+ 'enable_ipv6' => true,+ 'enable_backups' => true,+ ]);++ $response->assertStatus(201);++ Http::assertSent(fn (HttpRequest $request) => $request->method() === 'POST'+ && $request->url() === 'https://api.hetzner.cloud/v1/servers/456/actions/enable_backup');+ });+test('generates server name if not provided', function () {Http::fake(['https://api.hetzner.cloud/v1/ssh_keys*' => Http::response([diff --git a/tests/Feature/HetznerServerCreationTest.php b/tests/Feature/HetznerServerCreationTest.phpindex 9493ec0317..0e4a228db0 100644--- a/tests/Feature/HetznerServerCreationTest.php+++ b/tests/Feature/HetznerServerCreationTest.php@@ -197,6 +197,14 @@ describe('Boarding Flow Integration', function () {// Boarding should still be enabled since it wasn't created from onboardingexpect($this->team->fresh()->show_boarding)->toBeTrue();});++ test('shows the backups option with the pricing note in the create dialog', function () {+ Livewire::test(ByHetzner::class)+ ->set('current_step', 2)+ ->assertSet('enable_backups', false)+ ->assertSee('Enable Hetzner Backups')+ ->assertSee('additional 20% of the server monthly fee');+ });});describe('Hetzner data loading', function () {