commandosslabs/Coolify Docker Compose Deploy
Create or update a Coolify Docker Compose service, sync environment variables, and restart the service.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 18, 2026
- License
- Apache 2.0
Pinned Snippet
uses: commandosslabs/coolify-deploy-action@d3cef798f8b5db0cb8c7b881a5e31931af958916 # v1tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| coolify_domain | Coolify domain or base URL. Use `app.coolify.io` for Coolify Cloud, or your self-hosted Coolify domain. If the protocol is omitted, `https://` is used. The action appends `/api/v1` automatically unless it is already present. | no | app.coolify.io |
| api_token | Coolify API token. | yes | — |
| docker_compose | Docker Compose file content or path to a compose file. If the value matches an existing file path, the file is read automatically. Otherwise, the value is treated as raw Docker Compose content. | yes | — |
| environment_variables | Service environment variables as a JSON array. Each entry must include `key`, `value`, and `is_secret`. | no | — |
| project_uuid | Project UUID. Required when `service_uuid` is not provided. | no | — |
| server_uuid | Server UUID. Required when `service_uuid` is not provided. | no | — |
| environment_name_or_uuid | Environment name or UUID. Required when `service_uuid` is not provided. | no | — |
| service_uuid | Existing Coolify service UUID. If provided, the action updates this service and returns the same UUID. If omitted, the action creates a new Docker Compose service and returns the new UUID. | no | — |
| service_options | JSON object sent to PATCH /services/{uuid}. Supported fields: `name`, `description`, `urls`. Other fields are ignored with a warning. These options are not sent when creating a new service; they are applied via a separate update call after creation. | no | — |
| request_timeout_ms | HTTP request timeout in milliseconds. | no | 30000 |
| request_retry_count | Number of times to retry timed-out or unknown transport errors. HTTP response errors from Coolify are not retried. | no | 0 |
Outputs
| name | description |
|---|---|
| service_uuid | Coolify service UUID. |
| created | Whether the action created a new service. |