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(applications): add configurable restart loop limit
ShadowArcanist886d01405f5d
diff --git a/app/Actions/Docker/GetContainersStatus.php b/app/Actions/Docker/GetContainersStatus.phpindex 5966876c6e..cfac835837 100644--- a/app/Actions/Docker/GetContainersStatus.php+++ b/app/Actions/Docker/GetContainersStatus.php@@ -2,6 +2,7 @@namespace App\Actions\Docker;+use App\Actions\Application\StopApplication;use App\Actions\Database\StartDatabaseProxy;use App\Actions\Database\StopDatabaseProxy;use App\Actions\Shared\ComplexStatusCheck;@@ -9,6 +10,7 @@ use App\Events\ServiceChecked;use App\Models\ApplicationPreview;use App\Models\Server;use App\Models\ServiceDatabase;+use App\Notifications\Application\RestartLimitReached as ApplicationRestartLimitReached;use App\Services\ContainerStatusAggregator;use App\Traits\CalculatesExcludedStatus;use Illuminate\Support\Arr;@@ -475,16 +477,11 @@ class GetContainersStatus'last_restart_type' => 'crash',]);- // Send notification- $containerName = $application->name;- $projectUuid = data_get($application, 'environment.project.uuid');- $environmentName = data_get($application, 'environment.name');- $applicationUuid = data_get($application, 'uuid');-- if ($projectUuid && $applicationUuid && $environmentName) {- $url = base_url().'/project/'.$projectUuid.'/'.$environmentName.'/application/'.$applicationUuid;- } else {- $url = null;+ // Check if restart limit has been reached+ $maxAllowedRestarts = $application->max_restart_count ?? 0;+ if ($maxAllowedRestarts > 0 && $maxRestartCount >= $maxAllowedRestarts && $previousRestartCount < $maxAllowedRestarts) {+ StopApplication::dispatch($application);+ $application->environment->project->team?->notify(new ApplicationRestartLimitReached($application));}}diff --git a/app/Livewire/Project/Application/Advanced.php b/app/Livewire/Project/Application/Advanced.phpindex cf7ef3e0b2..9954c34221 100644--- a/app/Livewire/Project/Application/Advanced.php+++ b/app/Livewire/Project/Application/Advanced.php@@ -82,6 +82,9 @@ class Advanced extends Component#[Validate(['boolean'])]public bool $isConnectToDockerNetworkEnabled = false;+ #[Validate(['integer', 'min:0'])]+ public int $maxRestartCount = 10;+public function mount(){try {@@ -144,6 +147,7 @@ class Advanced extends Component$this->disableBuildCache = $this->application->settings->disable_build_cache;$this->injectBuildArgsToDockerfile = $this->application->settings->inject_build_args_to_dockerfile ?? true;$this->includeSourceCommitInBuild = $this->application->settings->include_source_commit_in_build ?? false;+ $this->maxRestartCount = $this->application->max_restart_count ?? 10;}}@@ -252,6 +256,21 @@ class Advanced extends Component}}+ public function saveMaxRestartCount()+ {+ try {+ $this->authorize('update', $this->application);+ $this->validate([+ 'maxRestartCount' => 'integer|min:0',+ ]);+ $this->application->max_restart_count = $this->maxRestartCount;+ $this->application->save();+ $this->dispatch('success', 'Max restart count saved.');+ } catch (\Throwable $e) {+ return handleError($e, $this);+ }+ }+public function render(){return view('livewire.project.application.advanced');diff --git a/app/Models/Application.php b/app/Models/Application.phpindex 4cc2dcf749..85a04041b5 100644--- a/app/Models/Application.php+++ b/app/Models/Application.php@@ -125,6 +125,7 @@ class Application extends BaseModelprotected $casts = ['http_basic_auth_password' => 'encrypted','restart_count' => 'integer',+ 'max_restart_count' => 'integer','last_restart_at' => 'datetime',];diff --git a/app/Notifications/Application/RestartLimitReached.php b/app/Notifications/Application/RestartLimitReached.phpnew file mode 100644index 0000000000..8709e7cd39--- /dev/null+++ b/app/Notifications/Application/RestartLimitReached.php@@ -0,0 +1,140 @@+<?php++namespace App\Notifications\Application;++use App\Models\Application;+use App\Notifications\CustomEmailNotification;+use App\Notifications\Dto\DiscordMessage;+use App\Notifications\Dto\PushoverMessage;+use App\Notifications\Dto\SlackMessage;+use Illuminate\Notifications\Messages\MailMessage;++class RestartLimitReached extends CustomEmailNotification+{+ public string $resource_name;++ public string $project_uuid;++ public string $environment_uuid;++ public string $environment_name;++ public ?string $resource_url = null;++ public ?string $fqdn;++ public int $restart_count;++ public int $max_restart_count;++ public function __construct(public Application $resource)+ {+ $this->onQueue('high');+ $this->resource_name = data_get($resource, 'name');+ $this->project_uuid = data_get($resource, 'environment.project.uuid');+ $this->environment_uuid = data_get($resource, 'environment.uuid');+ $this->environment_name = data_get($resource, 'environment.name');+ $this->fqdn = data_get($resource, 'fqdn', null);+ $this->restart_count = $resource->restart_count;+ $this->max_restart_count = $resource->max_restart_count;+ if (str($this->fqdn)->explode(',')->count() > 1) {+ $this->fqdn = str($this->fqdn)->explode(',')->first();+ }+ $this->resource_url = base_url()."/project/{$this->project_uuid}/environment/{$this->environment_uuid}/application/{$this->resource->uuid}";+ }++ public function via(object $notifiable): array+ {+ return $notifiable->getEnabledChannels('status_change');+ }++ public function toMail(): MailMessage+ {+ $mail = new MailMessage;+ $mail->subject("Coolify: {$this->resource_name} stopped - restart limit reached ({$this->restart_count}/{$this->max_restart_count})");+ $mail->view('emails.application-restart-limit-reached', [+ 'name' => $this->resource_name,+ 'fqdn' => $this->fqdn,+ 'resource_url' => $this->resource_url,+ 'restart_count' => $this->restart_count,+ 'max_restart_count' => $this->max_restart_count,+ ]);++ return $mail;+ }++ public function toDiscord(): DiscordMessage+ {+ return new DiscordMessage(+ title: ':warning: Restart limit reached',+ description: "{$this->resource_name} has been stopped after {$this->restart_count} restarts (limit: {$this->max_restart_count}).\n\n[Open Application in Coolify]({$this->resource_url})",+ color: DiscordMessage::errorColor(),+ isCritical: true,+ );+ }++ public function toTelegram(): array+ {+ $message = "Coolify: {$this->resource_name} has been stopped after {$this->restart_count} restarts (limit: {$this->max_restart_count}).";++ return [+ 'message' => $message,+ 'buttons' => [+ [+ 'text' => 'Open Application in Coolify',+ 'url' => $this->resource_url,+ ],+ ],+ ];+ }++ public function toPushover(): PushoverMessage+ {+ $message = "{$this->resource_name} has been stopped after {$this->restart_count} restarts (limit: {$this->max_restart_count}).";++ return new PushoverMessage(+ title: 'Restart limit reached',+ level: 'error',+ message: $message,+ buttons: [+ [+ 'text' => 'Open Application in Coolify',+ 'url' => $this->resource_url,+ ],+ ],+ );+ }++ public function toSlack(): SlackMessage+ {+ $title = 'Restart limit reached';+ $description = "{$this->resource_name} has been stopped after {$this->restart_count} restarts (limit: {$this->max_restart_count})";++ $description .= "\n\n*Project:* ".data_get($this->resource, 'environment.project.name');+ $description .= "\n*Environment:* {$this->environment_name}";+ $description .= "\n*Application URL:* {$this->resource_url}";++ return new SlackMessage(+ title: $title,+ description: $description,+ color: SlackMessage::errorColor()+ );+ }++ public function toWebhook(): array+ {+ return [+ 'success' => false,+ 'message' => 'Restart limit reached',+ 'event' => 'restart_limit_reached',+ 'application_name' => $this->resource_name,+ 'application_uuid' => $this->resource->uuid,+ 'restart_count' => $this->restart_count,+ 'max_restart_count' => $this->max_restart_count,+ 'url' => $this->resource_url,+ 'project' => data_get($this->resource, 'environment.project.name'),+ 'environment' => $this->environment_name,+ 'fqdn' => $this->fqdn,+ ];+ }+}diff --git a/database/migrations/2026_03_27_000000_add_max_restart_count_to_applications_and_databases.php b/database/migrations/2026_03_27_000000_add_max_restart_count_to_applications_and_databases.phpnew file mode 100644index 0000000000..578959c9a4--- /dev/null+++ b/database/migrations/2026_03_27_000000_add_max_restart_count_to_applications_and_databases.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('applications', function (Blueprint $blueprint) {+ $blueprint->integer('max_restart_count')->default(10)->after('restart_count');+ });+ }++ public function down(): void+ {+ Schema::table('applications', function (Blueprint $blueprint) {+ $blueprint->dropColumn('max_restart_count');+ });+ }+};diff --git a/resources/views/emails/application-restart-limit-reached.blade.php b/resources/views/emails/application-restart-limit-reached.blade.phpnew file mode 100644index 0000000000..e5fa01c006--- /dev/null+++ b/resources/views/emails/application-restart-limit-reached.blade.php@@ -0,0 +1,7 @@+<x-emails.layout>+{{ $name }} has been automatically stopped after {{ $restart_count }} crash restarts (limit: {{ $max_restart_count }}).++The application appears to be in a crash loop. Please investigate the issue and redeploy when ready.++[Check what is going on]({{ $resource_url }}).+</x-emails.layout>diff --git a/resources/views/livewire/project/application/advanced.blade.php b/resources/views/livewire/project/application/advanced.blade.phpindex 907500dfa5..92020334b9 100644--- a/resources/views/livewire/project/application/advanced.blade.php+++ b/resources/views/livewire/project/application/advanced.blade.php@@ -75,6 +75,14 @@helper="By default, you do not reach the Coolify defined networks.<br>Starting a docker compose based resource will have an internal network. <br>If you connect to a Coolify defined network, you maybe need to use different internal DNS names to connect to a resource.<br><br>For more information, check <a class='underline dark:text-white' target='_blank' href='https://coolify.io/docs/knowledge-base/docker/compose#connect-to-predefined-networks'>this</a>."canGate="update" :canResource="$application" />@endif+ <h3 class="pt-4">Restart Limit</h3>+ <form class="flex items-end gap-2" wire:submit.prevent='saveMaxRestartCount'>+ <x-forms.input type="number" min="0"+ helper="Maximum number of crash restarts before Coolify automatically stops the application and sends a notification. Set to 0 to disable the limit."+ id="maxRestartCount" label="Max Restart Count" canGate="update"+ :canResource="$application" />+ <x-forms.button canGate="update" :canResource="$application" type="submit">Save</x-forms.button>+ </form><h3 class="pt-4">Logs</h3><x-forms.checkbox helper="Drain logs to your configured log drain endpoint in your Server settings."instantSave id="isLogDrainEnabled" label="Drain Logs" canGate="update" :canResource="$application" />