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(rollback): list Docker registry images of recent deployments
Andras Bacsai3d8cea9e3cb0
diff --git a/app/Actions/Application/GetRollbackImages.php b/app/Actions/Application/GetRollbackImages.phpnew file mode 100644index 0000000000..73ab3931fa--- /dev/null+++ b/app/Actions/Application/GetRollbackImages.php@@ -0,0 +1,123 @@+<?php++namespace App\Actions\Application;++use App\Enums\ApplicationDeploymentStatus;+use App\Models\Application;+use Lorisleiva\Actions\Concerns\AsAction;++/**+ * Lists the images an application can roll back to: the images on its server, and the images of+ * recent successful deployments that were pushed to the Docker registry. The deployment pulls a+ * registry image again when the server no longer has it.+ */+class GetRollbackImages+{+ use AsAction;++ public const REGISTRY_DEPLOYMENTS_LIMIT = 10;++ /**+ * @return array{current: ?string, images: list<array{tag: string, created_at: ?string, is_current: bool, source: 'local'|'registry'}>}+ */+ public function handle(Application $application): array+ {+ $current = null;+ $images = collect();++ $server = $application->destination?->server;+ if ($server?->isFunctional()) {+ $output = instant_remote_process([+ "docker inspect --format='{{.Config.Image}}' {$application->uuid}",+ ], $server, throwError: false);+ $current = self::imageTag(str($output)->trim()->toString());++ $repository = $application->docker_registry_image_name ?: $application->uuid;+ $output = instant_remote_process([+ "docker images --format '{{.Repository}}#{{.Tag}}#{{.CreatedAt}}'",+ ], $server);+ $images = str($output)->trim()->explode("\n")+ ->map(fn (string $line) => explode('#', $line))+ // Exact repository match only, so other images with a similar name are not listed.+ ->filter(fn (array $parts) => $parts[0] === $repository && filled($parts[1] ?? null))+ ->map(fn (array $parts) => [+ 'tag' => $parts[1],+ 'created_at' => $parts[2] ?? null,+ 'is_current' => $parts[1] === $current,+ 'source' => 'local',+ ])+ ->keyBy('tag');+ }++ foreach ($this->registryImages($application, $current) as $image) {+ if (! $images->has($image['tag'])) {+ $images->put($image['tag'], $image);+ }+ }++ return [+ 'current' => $current,+ 'images' => $images->values()->all(),+ ];+ }++ /**+ * Each successful deployment pushes `<image name>:<commit>` to the registry, so the commits of+ * recent deployments are rollback targets. Docker image applications do not push, and+ * Dockerfile-only applications always push the `latest` tag.+ *+ * @return list<array{tag: string, created_at: ?string, is_current: bool, source: 'registry'}>+ */+ private function registryImages(Application $application, ?string $current): array+ {+ if (blank($application->docker_registry_image_name)+ || in_array($application->build_pack, ['dockerimage', 'dockercompose'], true)+ || filled($application->dockerfile)) {+ return [];+ }++ return $application->deployment_queue()+ ->where('status', ApplicationDeploymentStatus::FINISHED->value)+ ->where('pull_request_id', 0)+ ->whereNotNull('commit')+ ->where('commit', '!=', 'HEAD')+ ->select('commit')+ ->selectRaw('max(updated_at) as deployed_at')+ ->groupBy('commit')+ ->orderByDesc('deployed_at')+ ->limit(self::REGISTRY_DEPLOYMENTS_LIMIT)+ ->get()+ ->map(function ($deployment) use ($current) {+ // The same tag as the deployment job builds in generate_image_names().+ $tag = substr($deployment->commit, 0, 128);++ return [+ 'tag' => $tag,+ 'created_at' => $deployment->deployed_at,+ 'is_current' => $tag === $current,+ 'source' => 'registry',+ ];+ })+ ->values()+ ->all();+ }++ /**+ * The tag of an image reference such as `registry.example.com:5000/team/app:tag`, or null for a digest.+ */+ public static function imageTag(string $imageReference): ?string+ {+ if (str_contains($imageReference, '@')) {+ return null;+ }++ $lastColon = strrpos($imageReference, ':');+ $lastSlash = strrpos($imageReference, '/');++ if ($lastColon === false || ($lastSlash !== false && $lastColon < $lastSlash)) {+ return null;+ }++ return substr($imageReference, $lastColon + 1) ?: null;+ }+}diff --git a/app/Http/Controllers/Api/ApplicationsController.php b/app/Http/Controllers/Api/ApplicationsController.phpindex 3cd02d31ec..f829c04d88 100644--- a/app/Http/Controllers/Api/ApplicationsController.php+++ b/app/Http/Controllers/Api/ApplicationsController.php@@ -3,6 +3,7 @@namespace App\Http\Controllers\Api;use App\Actions\Application\CleanupPreviewDeployment;+use App\Actions\Application\GetRollbackImages;use App\Actions\Application\LoadComposeFile;use App\Actions\Application\StopApplication;use App\Enums\BuildPackTypes;@@ -6133,7 +6134,7 @@ class ApplicationsController extends Controller#[OA\Get(summary: 'List Rollback Images',- description: 'List available Docker images for rolling back an application. Returns an empty list when the server is unavailable or remote inspection is not possible.',+ description: 'List available Docker images for rolling back an application: images on the server (`local`) and, when a Docker registry image name is set, images of recent successful deployments in the registry (`registry`). Returns an empty list when the server is unavailable or remote inspection is not possible.',path: '/applications/{uuid}/rollback-images',operationId: 'list-application-rollback-images',security: [['bearerAuth' => []]],@@ -6157,6 +6158,7 @@ class ApplicationsController extends Controllernew OA\Property(property: 'tag', type: 'string'),new OA\Property(property: 'created_at', type: 'string'),new OA\Property(property: 'is_current', type: 'boolean'),+ new OA\Property(property: 'source', type: 'string', enum: ['local', 'registry']),])),@@ -6181,61 +6183,11 @@ class ApplicationsController extends Controller$this->authorize('view', $application);- $current = null;- $images = [];-try {- $server = $application->destination?->server;- if ($server && $server->isFunctional()) {- $image = $application->docker_registry_image_name ?? $application->uuid;- $output = instant_remote_process([- "docker inspect --format='{{.Config.Image}}' {$application->uuid}",- ], $server, throwError: false);- $current = self::currentRollbackImageTag(str($output)->trim()->toString());-- $output = instant_remote_process([- "docker images --format '{{.Repository}}#{{.Tag}}#{{.CreatedAt}}'",- ], $server);- $images = str($output)->trim()->explode("\n")->filter(function ($item) use ($image) {- $repository = str($item)->before('#')->toString();-- // Exact repository match only — avoid substring collisions across images.- return $repository === $image;- })->map(function ($item) use ($current) {- $parts = str($item)->explode('#');-- return [- 'tag' => $parts[1] ?? null,- 'created_at' => $parts[2] ?? null,- 'is_current' => ($parts[1] ?? null) === $current,- ];- })->values()->all();- }+ return response()->json(GetRollbackImages::run($application));} catch (\Throwable) {- $current = null;- $images = [];+ return response()->json(['current' => null, 'images' => []]);}-- return response()->json([- 'current' => $current,- 'images' => $images,- ]);- }-- private static function currentRollbackImageTag(string $imageReference): ?string- {- if (str_contains($imageReference, '@')) {- return null;- }-- $lastColon = strrpos($imageReference, ':');- $lastSlash = strrpos($imageReference, '/');-- if ($lastColon === false || ($lastSlash !== false && $lastColon < $lastSlash)) {- return null;- }-- return substr($imageReference, $lastColon + 1) ?: null;}#[OA\Post(diff --git a/app/Jobs/ApplicationDeploymentJob.php b/app/Jobs/ApplicationDeploymentJob.phpindex 9fa8621fb1..acc4d3e7b6 100644--- a/app/Jobs/ApplicationDeploymentJob.php+++ b/app/Jobs/ApplicationDeploymentJob.php@@ -1584,6 +1584,7 @@ class ApplicationDeploymentJob implements ShouldBeEncrypted, ShouldQueue'save' => 'local_image_found',]);if (str($this->saved_outputs->get('local_image_found'))->isEmpty() && $this->application->docker_registry_image_name) {+ $this->application_deployment_queue->addLogEntry("Image ({$this->production_image_name}) not found on the server. Pulling it from the Docker registry.");$this->execute_remote_command(['docker pull '.escapeshellarg($this->production_image_name).' 2>/dev/null','ignore_errors' => true,diff --git a/app/Livewire/Project/Application/Rollback.php b/app/Livewire/Project/Application/Rollback.phpindex f6a8e386b4..6e54ac3d38 100644--- a/app/Livewire/Project/Application/Rollback.php+++ b/app/Livewire/Project/Application/Rollback.php@@ -2,6 +2,7 @@namespace App\Livewire\Project\Application;+use App\Actions\Application\GetRollbackImages;use App\Models\Application;use App\Traits\AuditsApplicationSettings;use Illuminate\Foundation\Auth\Access\AuthorizesRequests;@@ -17,7 +18,7 @@ class Rollback extends Componentpublic $images = [];- public ?string $current;+ public ?string $current = null;public array $parameters;@@ -82,30 +83,7 @@ class Rollback extends Component$this->authorize('view', $this->application);try {- $image = $this->application->docker_registry_image_name ?? $this->application->uuid;- if ($this->application->destination->server->isFunctional()) {- $output = instant_remote_process([- "docker inspect --format='{{.Config.Image}}' {$this->application->uuid}",- ], $this->application->destination->server, throwError: false);- $current_tag = str($output)->trim()->explode(':');- $this->current = data_get($current_tag, 1);-- $output = instant_remote_process([- "docker images --format '{{.Repository}}#{{.Tag}}#{{.CreatedAt}}'",- ], $this->application->destination->server);- $this->images = str($output)->trim()->explode("\n")->filter(function ($item) use ($image) {- return str($item)->contains($image);- })->map(function ($item) {- $item = str($item)->explode('#');- $is_current = $item[1] === $this->current;-- return [- 'tag' => $item[1],- 'created_at' => $item[2],- 'is_current' => $is_current,- ];- })->toArray();- }+ ['current' => $this->current, 'images' => $this->images] = GetRollbackImages::run($this->application);$showToast && $this->dispatch('success', 'Images loaded.');return [];diff --git a/openapi.json b/openapi.jsonindex 07caa78eb6..8e3bda3333 100644--- a/openapi.json+++ b/openapi.json@@ -5688,7 +5688,7 @@"Applications"],"summary": "List Rollback Images",- "description": "List available Docker images for rolling back an application. Returns an empty list when the server is unavailable or remote inspection is not possible.",+ "description": "List available Docker images for rolling back an application: images on the server (`local`) and, when a Docker registry image name is set, images of recent successful deployments in the registry (`registry`). Returns an empty list when the server is unavailable or remote inspection is not possible.","operationId": "list-application-rollback-images","parameters": [{@@ -5726,6 +5726,13 @@},"is_current": {"type": "boolean"+ },+ "source": {+ "type": "string",+ "enum": [+ "local",+ "registry"+ ]}},"type": "object"@@ -13164,7 +13171,7 @@"$ref": "#\/components\/responses\/401"},"403": {- "description": "The token needs the deploy ability to set post_install_script_id or public_key_ids."+ "description": "The token needs the deploy permission for a post-install script or extra SSH keys."},"422": {"description": "Validation failed."@@ -17883,7 +17890,7 @@"Servers"],"summary": "Import server transfer bundle",- "description": "Import a server transfer bundle into this Coolify instance (adopt mode by default). This instance then manages the server, and Sentinel reports to it.",+ "description": "Import a server transfer bundle into this Coolify instance (adopt mode by default). This instance then manages the server, and Sentinel reports to it. Needs a token with the write and deploy permissions.","operationId": "import-server-transfer-bundle","requestBody": {"required": true,@@ -17924,6 +17931,9 @@"401": {"$ref": "#\/components\/responses\/401"},+ "403": {+ "description": "The token needs the write and deploy permissions."+ },"422": {"description": "Validation failed"}diff --git a/openapi.yaml b/openapi.yamlindex eebac91795..1dbe1c185c 100644--- a/openapi.yaml+++ b/openapi.yaml@@ -3716,7 +3716,7 @@ paths:tags:- Applicationssummary: 'List Rollback Images'- description: 'List available Docker images for rolling back an application. Returns an empty list when the server is unavailable or remote inspection is not possible.'+ description: 'List available Docker images for rolling back an application: images on the server (`local`) and, when a Docker registry image name is set, images of recent successful deployments in the registry (`registry`). Returns an empty list when the server is unavailable or remote inspection is not possible.'operationId: list-application-rollback-imagesparameters:-@@ -3734,7 +3734,7 @@ paths:schema:properties:current: { type: [string, 'null'] }- images: { type: array, items: { properties: { tag: { type: string }, created_at: { type: string }, is_current: { type: boolean } }, type: object } }+ images: { type: array, items: { properties: { tag: { type: string }, created_at: { type: string }, is_current: { type: boolean }, source: { type: string, enum: [local, registry] } }, type: object } }type: object'401':$ref: '#/components/responses/401'@@ -8441,7 +8441,7 @@ paths:'401':$ref: '#/components/responses/401''403':- description: 'The token needs the deploy ability to set post_install_script_id or public_key_ids.'+ description: 'The token needs the deploy permission for a post-install script or extra SSH keys.''422':description: 'Validation failed.''429':@@ -11318,7 +11318,7 @@ paths:tags:- Serverssummary: 'Import server transfer bundle'- description: 'Import a server transfer bundle into this Coolify instance (adopt mode by default). This instance then manages the server, and Sentinel reports to it.'+ description: 'Import a server transfer bundle into this Coolify instance (adopt mode by default). This instance then manages the server, and Sentinel reports to it. Needs a token with the write and deploy permissions.'operationId: import-server-transfer-bundlerequestBody:required: true@@ -11347,6 +11347,8 @@ paths:description: Imported'401':$ref: '#/components/responses/401'+ '403':+ description: 'The token needs the write and deploy permissions.''422':description: 'Validation failed'security:diff --git a/resources/views/livewire/project/application/rollback.blade.php b/resources/views/livewire/project/application/rollback.blade.phpindex c159af392c..9a32c1a411 100644--- a/resources/views/livewire/project/application/rollback.blade.php+++ b/resources/views/livewire/project/application/rollback.blade.php@@ -22,7 +22,7 @@</form><x-application.settings-section id="rollback-images-section" title="Available images"- helper="Rollback uses an existing local image without rebuilding the application." flush>+ helper="Rollback uses an existing image without rebuilding the application. Images in the Docker registry are pulled to the server first." flush><x-slot:actions>@can('view', $application)<x-forms.button wire:click="loadImages(true)">@@ -41,6 +41,7 @@$isPrTag = preg_match('/^pr-\d+$/', $tag);$isRollbackable = $isCommitSha || $isPrTag;$isCurrent = data_get($image, 'is_current');+ $isRegistryImage = data_get($image, 'source') === 'registry';@endphp<divclass="flex flex-col gap-3 border-b border-neutral-200 px-4 py-3.5 last:border-b-0 sm:flex-row sm:items-center dark:border-white/[0.07]">@@ -58,9 +59,12 @@@elseif (!$isRollbackable)<x-status-badge status="Rollback unavailable" type="neutral" />@endif+ @if ($isRegistryImage)+ <x-status-badge status="In registry" type="neutral" />+ @endif</div><p class="mt-1 text-xs text-neutral-500 dark:text-fg-dim">- Built {{ $createdAt->diffForHumans() }}+ {{ $isRegistryImage ? 'Deployed' : 'Built' }} {{ $createdAt->diffForHumans() }}<span class="mx-1 text-neutral-300 dark:text-fg-faint">·</span>{{ $date }}</p>@@ -84,7 +88,7 @@</div>@empty<x-empty title="No rollback images"- description="No previous application images are currently stored on this server."+ description="No previous application images are stored on this server or in the Docker registry."icon-name="layers" />@endforelse</div>diff --git a/tests/Feature/Api/ApplicationRollbackImagesApiTest.php b/tests/Feature/Api/ApplicationRollbackImagesApiTest.phpindex 4e61000ba7..ac94113353 100644--- a/tests/Feature/Api/ApplicationRollbackImagesApiTest.php+++ b/tests/Feature/Api/ApplicationRollbackImagesApiTest.php@@ -1,21 +1,13 @@<?php-use App\Http\Controllers\Api\ApplicationsController;--function currentRollbackImageTag(string $imageReference): ?string-{- $method = new ReflectionMethod(ApplicationsController::class, 'currentRollbackImageTag');- $method->setAccessible(true);-- return $method->invoke(null, $imageReference);-}+use App\Actions\Application\GetRollbackImages;it('extracts the current rollback image tag when the registry includes a port', function () {- expect(currentRollbackImageTag('registry.example.com:5000/team/application:commit-sha'))+ expect(GetRollbackImages::imageTag('registry.example.com:5000/team/application:commit-sha'))->toBe('commit-sha');});it('does not treat a digest as the current rollback image tag', function () {- expect(currentRollbackImageTag('registry.example.com:5000/team/application@sha256:'.str_repeat('a', 64)))+ expect(GetRollbackImages::imageTag('registry.example.com:5000/team/application@sha256:'.str_repeat('a', 64)))->toBeNull();});diff --git a/tests/Feature/GetRollbackImagesTest.php b/tests/Feature/GetRollbackImagesTest.phpnew file mode 100644index 0000000000..a9937a70ac--- /dev/null+++ b/tests/Feature/GetRollbackImagesTest.php@@ -0,0 +1,82 @@+<?php++use App\Actions\Application\GetRollbackImages;+use App\Enums\ApplicationDeploymentStatus;+use App\Models\Application;+use App\Models\ApplicationDeploymentQueue;+use App\Models\Environment;+use App\Models\Project;+use App\Models\Server;+use App\Models\StandaloneDocker;+use App\Models\Team;+use Illuminate\Foundation\Testing\RefreshDatabase;++uses(RefreshDatabase::class);++beforeEach(function () {+ $team = Team::factory()->create();+ // The server is not reachable, so only registry images are listed and no SSH command runs.+ $server = Server::factory()->create(['team_id' => $team->id]);+ $destination = StandaloneDocker::factory()->create(['server_id' => $server->id, 'network' => 'rollback-test']);+ $environment = Environment::factory()->create(['project_id' => Project::factory()->create(['team_id' => $team->id])->id]);++ $this->application = Application::factory()->create([+ 'environment_id' => $environment->id,+ 'destination_id' => $destination->id,+ 'destination_type' => StandaloneDocker::class,+ 'build_pack' => 'nixpacks',+ 'docker_registry_image_name' => 'ghcr.io/coollabs/app',+ ]);+});++function rollbackDeployment(Application $application, string $commit, string $finishedAt, array $attributes = []): void+{+ ApplicationDeploymentQueue::create([+ 'application_id' => $application->id,+ 'deployment_uuid' => fake()->uuid(),+ 'commit' => $commit,+ 'status' => ApplicationDeploymentStatus::FINISHED->value,+ 'pull_request_id' => 0,+ ...$attributes,+ ])->forceFill(['updated_at' => $finishedAt])->saveQuietly();+}++it('lists the commits of successful deployments as registry images, newest first and once per commit', function () {+ rollbackDeployment($this->application, 'aaaaaaa', '2026-10-01 10:00:00');+ rollbackDeployment($this->application, 'bbbbbbb', '2026-10-02 10:00:00');+ rollbackDeployment($this->application, 'aaaaaaa', '2026-10-03 10:00:00');+ rollbackDeployment($this->application, 'ccccccc', '2026-10-04 10:00:00', ['status' => ApplicationDeploymentStatus::FAILED->value]);+ rollbackDeployment($this->application, 'ddddddd', '2026-10-04 10:00:00', ['pull_request_id' => 5]);+ rollbackDeployment($this->application, 'HEAD', '2026-10-04 10:00:00');++ $result = GetRollbackImages::run($this->application);++ expect($result['current'])->toBeNull()+ ->and($result['images'])->toBe([+ ['tag' => 'aaaaaaa', 'created_at' => '2026-10-03 10:00:00', 'is_current' => false, 'source' => 'registry'],+ ['tag' => 'bbbbbbb', 'created_at' => '2026-10-02 10:00:00', 'is_current' => false, 'source' => 'registry'],+ ]);+});++it('limits the registry images to the most recent deployments', function () {+ foreach (range(1, GetRollbackImages::REGISTRY_DEPLOYMENTS_LIMIT + 2) as $day) {+ rollbackDeployment($this->application, sprintf('%07d', $day), sprintf('2026-10-%02d 10:00:00', $day));+ }++ $images = GetRollbackImages::run($this->application)['images'];++ expect($images)->toHaveCount(GetRollbackImages::REGISTRY_DEPLOYMENTS_LIMIT)+ ->and($images[0]['tag'])->toBe(sprintf('%07d', GetRollbackImages::REGISTRY_DEPLOYMENTS_LIMIT + 2));+});++it('lists no registry images when the application does not push commit images', function (array $attributes) {+ $this->application->update($attributes);+ rollbackDeployment($this->application, 'aaaaaaa', '2026-10-01 10:00:00');++ expect(GetRollbackImages::run($this->application->fresh())['images'])->toBe([]);+})->with([+ 'no registry image name' => [['docker_registry_image_name' => null]],+ 'docker image build pack' => [['build_pack' => 'dockerimage']],+ 'docker compose build pack' => [['build_pack' => 'dockercompose']],+ 'dockerfile without git' => [['build_pack' => 'dockerfile', 'dockerfile' => 'FROM nginx']],+]);