nuc/.artifacts/2026-02-01_13-20_task-runners-healthcheck-fix.md

Task Runners Health Check Fix

Date: 2026-02-01 13:20 Context: Fixed unhealthy status on n8n task-runners container

Problem

The task-runners-uk0o04o0g84s4sc80kkoooc0 container was showing as unhealthy with 60,395+ consecutive failures.

Root Cause: Health check was configured to hit / but the actual health endpoint is /healthz

Configured	Actual Endpoint
http://127.0.0.1:5680/	Returns 404
http://127.0.0.1:5680/healthz	Returns {"status":"ok"}

Solution

Updated Coolify's docker-compose configuration for the n8n service:

docker exec coolify php artisan tinker --execute="
use App\Models\Service;
\$service = Service::find(4);
\$compose = \$service->docker_compose_raw;
\$compose = str_replace(
    \"'wget -qO- http://127.0.0.1:5680/'\",
    \"'wget -qO- http://127.0.0.1:5680/healthz'\",
    \$compose
);
\$service->docker_compose_raw = \$compose;
\$service->save();
"

Then restarted the service:

docker exec coolify php artisan tinker --execute="
use App\Models\Service;
use App\Actions\Service\StopService;
use App\Actions\Service\StartService;
\$service = Service::find(4);
StopService::run(\$service);
StartService::run(\$service);
"

Result

• Container now shows as healthy
• Health check correctly hitting /healthz endpoint

Related

• n8n Service ID: 4
• n8n Service UUID: uk0o04o0g84s4sc80kkoooc0
• Coolify: http://192.168.1.3:8000