coolify-cli  by coollabsio

CLI for managing self-hosted application deployments

Created 2 years ago
322 stars

Top 84.4% on SourcePulse

GitHubView on GitHub
Project Summary

This CLI provides programmatic control over the Coolify platform, enabling developers and DevOps engineers to automate infrastructure management tasks. It streamlines the deployment, configuration, and monitoring of applications, databases, and services, integrating seamlessly into CI/CD pipelines and workflows.

How It Works

The coolify-cli employs a clean architecture, featuring a Service Layer for business logic and API interactions, an Output Layer for consistent command formatting, a Config Layer for managing multiple Coolify contexts (API tokens, URLs), and a Models Layer for type-safe data structures. This design promotes maintainability and extensibility for complex infrastructure operations.

Quick Start & Requirements

  • Installation: Options include a bash install script (curl ... | bash), Homebrew (brew install coollabsio/coolify-cli/coolify-cli), PowerShell (irm ... | iex), or go install github.com/coollabsio/coolify-cli/coolify@latest.
  • Prerequisites: A Coolify API token is required. Users must configure contexts using coolify context set-token cloud <token> or coolify context add -d <context_name> <url> <token> for self-hosted instances.
  • Links: Installation scripts are available at the specified URLs.

Highlighted Details

  • Comprehensive command set for managing servers, projects, applications (including environment variables and deployments), databases (with backup configurations), and services.
  • Robust context management allows seamless switching between multiple Coolify instances and API tokens.
  • Supports deployment workflows via UUID, name, or batch, including force deployments and preview deployments with Docker tag overrides.
  • Integration capabilities via GitHub App management for repositories and branches.
  • Configurable database backup strategies, including S3 integration and retention policies.
  • Output formatting options: table (default), JSON, and pretty JSON for scripting and debugging.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or roadmap were present in the provided documentation.

Licensing & Compatibility

The project is licensed under the MIT License, a permissive license suitable for commercial use and integration into closed-source projects.

Limitations & Caveats

The provided documentation does not explicitly detail limitations, alpha status, or known bugs. The CLI appears designed to cover the core functionalities exposed by the Coolify API.

Health Check
Last Commit

5 days ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
1
Star History
53 stars in the last 30 days

Explore Similar Projects

Starred by Eric Zhu Eric Zhu(Coauthor of AutoGen; Research Scientist at Microsoft Research), Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), and
27 more.

goose by aaif-goose

1.2%
43k
Open-source AI agent for automating complex engineering tasks
Created 1 year ago
Updated 6 hours ago
Feedback? Help us improve.