coolify-operator

Manages self-hosted Coolify deployments and infrastructure via CLI and REST API.

47|4|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/fabricioctelles/skills --skill coolify-operator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coolify-operator
Source: https://github.com/fabricioctelles/skills/tree/main/skills/coolify-operator
Command: npx skills add https://github.com/fabricioctelles/skills --skill coolify-operator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the complexity of managing self-hosted Coolify deployments by providing safe, structured guidance for connecting to instances, operating resources, troubleshooting failures, and handling multiple environments.

Core Features & Use Cases

  • CLI and REST API Operations: Connect to Coolify, verify authentication, and manage applications, servers, databases, services, and deployments.
  • Deployment Management: List applications, start, stop, restart, force-rebuild, inspect status, and view deployment logs.
  • Environment and Context Management: Configure multiple development, staging, and production contexts and synchronize application environment variables.
  • Troubleshooting and Safety: Diagnose authentication and endpoint errors, safely handle tokens containing pipe characters, verify resource UUIDs, and validate destructive operations.
  • Use Case: Restart an application after updating its environment variables, force a rebuild, and inspect its logs if deployment progress stalls.

Quick Start

Use the coolify operator skill to connect to my Coolify instance, list the applications, and restart the application with the UUID I provide.

Frequently Asked Questions about coolify-operator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage self-hosted Coolify deployments using the REST API?

Manage self-hosted Coolify deployments by using the REST API and CLI to connect, verify authentication, and execute operations like application restarts, force rebuilds, and status inspections. The process requires safe credential handling and correct endpoint formats.

What's the best way to synchronize environment variables across multiple Coolify deployment contexts?

Synchronize environment variables across development, staging, and production contexts by configuring multiple environment management profiles. This ensures application variables are correctly applied when restarting or rebuilding applications through the Coolify CLI.

Why does my Coolify CLI authentication fail when my API token contains pipe characters?

Coolify CLI authentication fails when API tokens contain pipe characters due to shell parsing issues. Safely handle credentials by properly escaping pipe characters or using secure environment variable injection to validate your connection.

Can I diagnose stalled Coolify deployments and inspect application logs without accessing the server directly?

Diagnose stalled Coolify deployments by inspecting deployment logs and application status remotely via the REST API. You can view progress, verify resource UUIDs, and receive error-aware operational guidance without direct server access.

How do I safely execute destructive operations like force rebuilding a Coolify application?

Safely execute destructive Coolify operations like force rebuilding by verifying resource UUIDs and validating connection endpoints beforehand. This error-aware approach prevents accidental modification of incorrect infrastructure resources.

Does the Coolify operator work for managing both application deployments and server infrastructure resources?

The Coolify operator manages both application deployments and server infrastructure resources. It handles application start, stop, and restart operations, alongside server, database, and service management through the official CLI and REST API.