DEV Community

Vigilmon
Vigilmon

Posted on

How to Monitor Your Coolify Deployments with Vigilmon

#coolify #selfhosted #monitoring #devops

Coolify is a popular self-hosted platform for deploying applications, databases, and services on your own infrastructure. If you use Coolify to manage your production deployments, you need uptime monitoring to know when those deployments stop responding to users.

Vigilmon pairs perfectly with Coolify - it monitors your deployed applications from outside, the same way your users access them.

Why Coolify Deployments Need Uptime Monitoring

Coolify handles the deployment workflow, but it does not continuously verify that your applications are responding to external traffic. Things Coolify cannot detect for you:

  • Your application crashes after deployment - Coolify marks the deploy as successful, but the app exits shortly after
  • An external network issue blocks traffic to your server while the container is healthy
  • A resource constraint (OOM, disk full) causes intermittent failures
  • A dependency goes down - your database or external API fails silently
  • SSL certificate renewal fails - your HTTPS stops working without any container-level alert

Uptime monitoring watches your services from the outside, catching all of these failure modes.

What to Monitor in a Coolify Deployment

Your Application URLs

For each service you deploy through Coolify, identify its public URL and add it to Vigilmon:

https://app.yourdomain.com          -> Main application
https://api.yourdomain.com/health   -> API health check
https://admin.yourdomain.com        -> Admin panel
Enter fullscreen mode Exit fullscreen mode

Health Check Endpoints

Add a /health endpoint to your applications that Vigilmon can check. This endpoint should validate your app's internal dependencies and return 200 OK when healthy or 503 when dependencies are failing.

SSL Certificates

Enable SSL certificate monitoring in Vigilmon for all HTTPS endpoints. Get alerted 30 days before expiry.

Setting Up Vigilmon for Coolify

Step 1: Create Your Account

Sign up at vigilmon.online. The free tier is sufficient for monitoring a standard Coolify deployment.

Step 2: Add Monitors for Each Deployed Application

For each application deployed in Coolify:

  1. Click New Monitor -> HTTP(S)
  2. Enter the application URL
  3. Set check interval: 1 minute for production services
  4. Set expected status: 200
  5. Enable SSL certificate monitoring
  6. Enable multi-region checks

Step 3: Use Vigilmon Alongside Coolify Health Checks

Coolify has built-in health check configuration for containers. Use both together:

  • Coolify health checks: Restart containers that fail their health check (internal recovery)
  • Vigilmon monitoring: Alert you when the service is externally unavailable (human notification)

Coolify auto-heals when it can; Vigilmon alerts you when Coolify's healing is not enough.

Step 4: Create a Status Page

If you use Coolify to host services for customers or internal teams, create a Vigilmon status page. This gives stakeholders a single URL to check service health without contacting you.

Step 5: Add Heartbeat Monitoring for Cron Jobs

If you run scheduled tasks via Coolify's cron job feature or inside your deployed containers, add a heartbeat ping at the end of each job:

#!/bin/bash
/usr/local/bin/backup.sh
curl -fsS "https://vigilmon.online/api/heartbeat/YOUR_HEARTBEAT_ID" > /dev/null
Enter fullscreen mode Exit fullscreen mode

Monitoring Coolify Itself

Consider monitoring the Coolify dashboard:

https://coolify.yourdomain.com -> Coolify dashboard availability
Enter fullscreen mode Exit fullscreen mode

If Coolify is down, you cannot deploy or manage your applications.

Handling Coolify Deployment Events

When you trigger a new deployment in Coolify, your service will briefly restart. Configure Vigilmon to use a 2-failure threshold before alerting - this prevents false alarms during the restart window.

Recommended Vigilmon Settings for Coolify Deployments

Setting Staging Production
Check interval 5 minutes 1 minute
Failure threshold 3 failures 2 failures
Timeout 15 seconds 10 seconds
SSL monitoring Optional Always enabled
Recovery notification Optional Always enabled

Conclusion

Coolify simplifies self-hosted application deployments. Vigilmon ensures those deployments stay up and you're the first to know when they do not. Together, they give you a complete self-hosted production stack with deployment automation and external uptime visibility.

Start monitoring your Coolify deployments for free: vigilmon.online - no credit card required.

Top comments (0)