---

name: coolify description: Manage deployments on Coolify using the coolify CLI script. Deploy applications, manage custom domains, and monitor status. homepage: https://coolify.bradarr.com metadata: {"clawdbot":{"emoji":"🚀","requires":{"env":["COOLIFY_API_TOKEN"]},"version":"2.2.0"}}

Coolify Deployment Skill (v2.2.0)

Manage deployments on Coolify self-hosted platform using the Python CLI script.

Setup

1. Set API Token

Copyexport COOLIFY_API_TOKEN="your-api-token"

Get your token from https://coolify.bradarr.com → Settings → API Keys.

2. Test Installation

Copypython scripts/coolify.py status

---

Commands

Quick Status

Copypython scripts/coolify.py status

Shows all applications, projects, and servers with counts.

Applications

List All Applications

Copypython scripts/coolify.py apps list

Shows all applications with status icons.

Get Application Details

Copypython scripts/coolify.py apps get --uuid <uuid>

Shows full details for one application.

Deploy Application

Copypython scripts/coolify.py apps deploy --uuid <uuid>
python scripts/coolify.py apps deploy --uuid <uuid> --no-force  # Don't force rebuild

Wait for Deployment

Copypython scripts/coolify.py apps wait --uuid <uuid>
python scripts/coolify.py apps wait --uuid <uuid> --timeout 600  # 10 minute timeout

Blocks until deployment completes or times out.

Get Logs

Copypython scripts/coolify.py apps logs --uuid <uuid>
python scripts/coolify.py apps logs --uuid <uuid> --count 200  # More lines

Create Application

Copypython scripts/coolify.py apps create \
  --name my-app \
  --repository https://github.com/user/repo \
  --build-pack dockerfile \
  --branch main

Projects

Copypython scripts/coolify.py projects list

Servers

Copypython scripts/coolify.py servers list

---

Programmatic Usage

Import the API directly in Python scripts:

Copyfrom scripts.coolify import CoolifyAPI

api = CoolifyAPI()

# Check health
if not api.health_check():
    print("API not accessible!")

# List apps
apps = api.apps_list()
for app in apps:
    print(f"{app['name']}: {app['status']}")

# Create and deploy
app = api.apps_create(
    name="my-app",
    repository="https://github.com/user/repo"
)
print(f"Created: {app['uuid']}")

# Wait for deployment
result = api.apps_wait_for_deployment(app['uuid'], timeout=300)
print(result['message'])

---

Common Workflows

Deploy New Application with Custom Domain

Copy# Create the application
python scripts/coolify.py apps create \
  --name my-website \
  --repository https://github.com/user/my-website

# Get the UUID from output, then add domain
# Note: Custom domain requires manual traefik configuration

# Deploy
python scripts/coolify.py apps deploy --uuid <uuid>

# Wait for completion
python scripts/coolify.py apps wait --uuid <uuid>

Check Application Health

Copy# Get status
python scripts/coolify.py apps get --uuid <uuid> | grep status

# Get logs if unhealthy
python scripts/coolify.py apps logs --uuid <uuid>

---

Error Handling

"COOLIFY_API_TOKEN not set"

Copyexport COOLIFY_API_TOKEN="your-token"

"Invalid UUID format"

Ensure UUID is in correct format (e.g., w8ogsc44w0cswcww8wwwg8o4)

"Repository URL must start with https://, http://, git://, or git@"

Copy# Wrong
--repository github.com/user/repo

# Correct
--repository https://github.com/user/repo

Deployment fails

Copy# Check logs
python scripts/coolify.py apps logs --uuid <uuid>

---

API Reference

CoolifyAPI Methods

Validators

Copyfrom scripts.coolify import CoolifyValidators

# Validate inputs before API calls
CoolifyValidators.validate_uuid(uuid)
CoolifyValidators.validate_repository_url(url)
CoolifyValidators.validate_domain(domain)
CoolifyValidators.validate_build_pack(pack)

---

Environment Variables

---

Known UUIDs (Clawd Workspace)

---

See Also

• Coolify Dashboard: https://coolify.bradarr.com
• Coolify Docs: https://coolify.io/docs

---

🦞 Deploy with confidence