LLMs.txtLLMs.txtDirectory

Coolify

coolify.io
Developer Tools

An open-source & self-hostable Heroku / Netlify / Vercel alternative

llms.txt

Docs

  • Coolify: Coolify is an open-source Platform as a Service (PaaS) for self-hosting databases, services, and applications with free SSL, backups, and Git integration.

  • Get Started

    • Setup

    • Introduction: Coolify is an open-source self-hosted PaaS alternative to Vercel, Heroku, and Railway with unlimited deployments, no vendor lock-in, and free SSL.

    • Installation: Install Coolify self-hosted PaaS on Linux servers with automated Docker setup script, manual configuration, SSH access, and firewall setup.

    • Upgrading: Upgrade self-hosted Coolify automatically, semi-automatically with UI notifications, or manually via terminal with version-specific installation.

    • Upgrading (internal Postgresql): Upgrade or roll back the PostgreSQL database used by your self-hosted Coolify instance.

    • Downgrading: Downgrade self-hosted Coolify to previous versions by disabling auto-update, using SSH terminal commands, and handling database compatibility risks.

    • Uninstalling: Completely remove Coolify from your self-hosted server by stopping containers, deleting volumes, networks, data directories, and Docker images.

    • Coolify Cloud: Coolify Cloud is a fully managed PaaS service with zero maintenance, automatic scaling, daily backups, and email notifications.

    • Learn

    • Usage: Compare Coolify Cloud managed service starting at $5/month versus free self-hosted deployment with maintenance, support, and backup differences.

    • Concepts: Learn core Coolify concepts including servers, resources, environments, projects, Docker containers, reverse proxy, and team management basics.

    • UI Screenshots: View screenshots of Coolify's user interface showing dashboard, deployment options, server management, and application configuration features.

    • Tutorial videos: Watch community video tutorials on Coolify self-hosted PaaS including installation, deployment, and complete walkthroughs for beginners.

    • Community

    • coolLabs Team: Meet the international team developing Coolify including founder Andras Bacsai, core developers, community leads, and documentation maintainers.

    • Support: Get Coolify support through Discord community with 19K+ members, direct email support for Cloud users, and core team developer assistance.

    • Coolify Sponsors: Meet the companies and organizations sponsoring Coolify development including hosting, infrastructure, and developer-tool partners.

    • Contribute

      • Contributing to Core: Contribute to Coolify open-source development with step-by-step setup guide, Docker environment, Spin commands, and pull request workflow.
      • Add a new service template to Coolify: Add new service templates to Coolify using Docker Compose with magic environment variables, storage handling, and one-click deployment features.
      • Contributing to Documentation: Contribute to Coolify docs with this guide covering repository setup, local development with Bun, image guidelines, and pull request workflow.

  • Applications

    • Applications: Deploy web applications on Coolify with Nixpacks, Docker, static sites, build packs, environment variables, and automated deployments.

    • Frameworks

    • Django: Deploy Django applications on Coolify with gunicorn, automatic builds, environment variables, and Python package management.

    • Jekyll: Deploy Jekyll static sites on Coolify using Nixpacks or Dockerfile with Ruby, Nginx, and automated build processes.

    • Laravel: Deploy Laravel PHP applications on Coolify with Nixpacks, queue workers, scheduler, supervisor, database, and Redis integration.

    • Phoenix: Deploy Phoenix framework applications on Coolify with Elixir/Erlang, Nixpacks, environment variables, and database integration.

    • Ruby on Rails: Deploy Ruby on Rails applications on Coolify with database migrations, MVC pattern support, and automated deployment workflows.

    • Symfony: Deploy Symfony PHP applications on Coolify with Nixpacks, Doctrine migrations, database connections, and trusted proxy configuration.

    • NextJS: Deploy Next.js applications on Coolify with server-side rendering, static builds, Nixpacks, or custom Dockerfile configurations.

    • Vite: Deploy Vite applications on Coolify with TypeScript or JavaScript, Nixpacks build process, and static site generation.

    • Vue: Deploy Vue.js applications on Coolify with server builds using Node/Express or static SPA builds with routing support.

    • Nuxt: Deploy Nuxt applications on Coolify with server builds, static generation, and Nitro support using Nixpacks build configurations.

    • SvelteKit: Deploy SvelteKit applications on Coolify with static builds using adapter-static or Node server builds with adapter-node.

    • Build Packs

      • Build Packs: Choose from Nixpacks, Static, Dockerfile, or Docker Compose build packs to create optimized Docker images for your application deployments.
      • Static Build Packs: Deploy static websites with Nginx web server using pre-built files from Git repositories, supporting Astro, Webstudio, and other static generators.
      • Nixpacks Build Pack
        • Nixpacks Build Pack: Build applications with Nixpacks automatic buildpack detecting your codebase, generating Dockerfiles, and deploying static sites or dynamic apps.
        • Node.js Versioning: How to pin specific Node.js minor and patch versions in Nixpacks using nixpkgs archive overrides.
      • Railpack Build Pack: Build applications with Railpack — the successor to Nixpacks — automatically detecting your codebase, building optimized images, and deploying static sites or dynamic apps.
      • Dockerfile Build Pack: Build Docker images from your custom Dockerfile with Coolify supporting Git repositories, environment variables, and pre/post-deployment commands.
      • Docker Compose Build Packs: Deploy multi-container applications with Docker Compose using custom domains, magic environment variables, storage volumes, and service networking.

    • CI/CD

      • CI/CD with Git Providers: Learn how Coolify applications integrate with Git providers for continuous deployment. Understand the difference between Git-based applications and Docker Compose services.
      • Github
        • Overview: Integrate GitHub with Coolify to deploy applications from repositories, enable automatic deployments, and manage pull requests seamlessly.
        • GitHub Actions: Deploy applications using GitHub Actions to build Docker images and trigger redeployments in Coolify.
        • GitHub Auto Deploy: Automatically deploy applications from GitHub repositories in Coolify using GitHub Apps, Actions, or webhooks.
        • GitHub Preview Deploy: Automatically deploy preview versions of your application for each GitHub pull request using Coolify.
        • Deploy Public Repository: Learn how to deploy applications from public GitHub repositories directly using the repository URL in Coolify.
        • GitHub Deploy Key: Deploy applications from private GitHub repositories using deploy keys in Coolify.
        • Setup GitHub App: Set up a GitHub App in Coolify to access and deploy from private GitHub repositories using automated or manual installation methods.
        • Switch GitHub Apps: Learn how to switch your application from one GitHub App to another in Coolify, such as when moving repositories to a new organization.
      • Gitlab
        • Integration: Connect GitLab repositories to Coolify with deploy keys, Gitlab container registry with deploy token, automatic webhooks, and merge request deployments for CI/CD automation
      • Bitbucket
        • Integration: Deploy Bitbucket repositories with Coolify using deploy keys, SSH authentication, and automated webhooks for commits and pull requests.
      • Gitea
        • Integration: Deploy Gitea repositories with Coolify using deploy keys, SSH authentication, and automated webhooks for commits and pull requests.
      • Other Git Providers: Connect any Git provider to Coolify using deploy keys and webhooks for automatic deployments. Works with Gogs, Forgejo, and custom Git servers.

  • Services

    • Services
    • Overview: Browse the complete directory of one-click services available in Coolify, including databases, development tools, and productivity apps.
    • All Services: Complete directory of one-click services in Coolify including AI, analytics, databases, CMS, monitoring, and more.

  • Databases

    • Introduction: Deploy databases on Coolify with one-click setup for PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, DragonFly, and ClickHouse.
    • Database SSL: Secure database connections on Coolify with SSL encryption, automatic certificate generation, and multiple SSL modes for enhanced security.
    • Backups: Configure scheduled database backups for PostgreSQL, MySQL, MariaDB, and MongoDB with cron expressions and S3 storage integration.
    • MySQL: Deploy MySQL databases on Coolify with ACID compliance, replication, partitioning, full-text indexing, and automated backup features.
    • MariaDB: Deploy MariaDB databases on Coolify with MySQL compatibility, enhanced performance, additional storage engines, and automated backups.
    • PostgreSQL: Deploy PostgreSQL databases on Coolify with advanced features, automated backups, import/restore capabilities, and 30+ years of reliability.
    • MongoDB: Deploy MongoDB NoSQL databases on Coolify with flexible document storage, horizontal scalability, and automated backup solutions.
    • Redis: Deploy Redis in-memory databases on Coolify with caching, vector database, document storage, streaming, and message broker capabilities.
    • DragonFly: Deploy DragonFly in-memory datastore on Coolify with Redis compatibility, multi-threaded architecture, and enhanced scalability features.
    • KeyDB: Deploy KeyDB on Coolify with high-performance multithreading, Redis compatibility, active replication, and FLASH storage support.
    • ClickHouse: Deploy ClickHouse on Coolify with column-oriented OLAP database, real-time analytics, S3 backups, and exceptional query performance.

  • Integrations

    • Cloudflare
      • Tunnels
        • Cloudflare Tunnels: Connect Coolify resources securely without port forwarding using Cloudflare Tunnels for all resources, single apps, SSH access, or full HTTPS setups.
        • Access All Resource via Cloudflare Tunnels: Expose all Coolify resources securely through Cloudflare Tunnels without public IPs or port forwarding using wildcard domains and HTTP proxy routing.
        • Access Single Resource via Cloudflare Tunnels: Securely access individual Coolify applications through Cloudflare Tunnels with port mapping, domain configuration, and multi-resource tunneling support.
        • Server SSH Access via Cloudflare Tunnels: Enable secure SSH access to Coolify servers via Cloudflare Tunnels with automated or manual cloudflared installation hiding server IP addresses.
        • Full HTTPS/TLS Setup for All Resources: Configure end-to-end HTTPS for Coolify resources through Cloudflare Tunnels with Origin Certificates, strict TLS encryption, and proper domain setup.
      • Cloudflare DDoS Protection: Learn how to set up Cloudflare DDoS protection for applications deployed with Coolify.
    • MCP Server: Connect AI assistants like Claude Desktop and Cursor to your Coolify instance using the Model Context Protocol (MCP) for read-only infrastructure visibility.
    • Crowdsec

  • Knowledge Base

    • Overview: Comprehensive Coolify knowledge base covering deployment guides, server setup, Git integration, proxy configuration, and troubleshooting resources.

    • Internal

      • Scalability: Scale Coolify applications with traditional horizontal scaling across multiple servers using load balancers or Docker Swarm for high availability deployments.
      • Terminal: Access Coolify resources through built-in web terminal with xterm.js, secure SSH connections, and Websocket communication for all containers and servers.

    • Self-hosted Instance

    • Monitoring: Monitor Coolify resources with built-in disk usage tracking, automatic cleanup, container status monitoring, and backup status notifications.

    • Notifications: Configure multi-channel notifications in Coolify with Email, Telegram, Discord, Slack, Mattermost, Pushover, and Webhooks for deployments, backups, and server monitoring alerts.

    • Webhook Payloads: Reference for all Coolify webhook notification payloads, including application deployments, database backups, scheduled tasks, Docker cleanup, server events, and container events.

    • Coolify Instance Updates - Self-hosted: Configure automatic Coolify updates with custom cron schedules, manual update options, and service template synchronization for self-hosted instances.

    • Commands: Essential Coolify CLI commands for root password reset, email changes, and deleting stuck services via Docker exec and Artisan commands.

    • Delete User: Safely delete users from Coolify with automatic team ownership transfer, resource cleanup, and team member reassignment procedures.

    • OAuth: Set up OAuth authentication with GitHub, GitLab, Google, Azure, or Bitbucket for secure single sign-on access to your Coolify instance.

    • Single Sign-On (SSO): Set up Single Sign-On for Coolify with OpenID Connect. Includes a tested Okta configuration example.

    • Create Root User with Environment Variables: Create Coolify root user during installation with environment variables including email validation, username requirements, and strong password policies.

    • Define Custom Docker Network with Environment Variables: Configure custom Docker network CIDR blocks and address pools using environment variables during Coolify installation for advanced network setups

    • Custom Docker Registry: Switch between Docker Hub and GitHub Container Registry (ghcr.io) for pulling Coolify images during installation or runtime

    • Custom Compose Overrides: Customize Coolify's infrastructure containers using a docker-compose.custom.yml file that persists across upgrades

    • Change Localhost Key: Replace and regenerate Coolify's localhost SSH private key with safe database backup procedures and Docker container key installation.

    • DNS & Domains

    • DNS Configuration: Configure A records, wildcard domains, and autogenerated subdomains for Coolify applications with DNS setup examples and preview deployments.

    • Domains: Add custom domains to Coolify with FQDN format, multiple domain support, port mapping, path-based routing, wildcard domains, and custom DNS server validation.

    • Destinations

    • Introduction: Manage Docker network destinations in Coolify for isolated deployment environments supporting standalone Docker and Swarm cluster configurations.

    • Creating Destinations: Create Docker network destinations in Coolify for standalone or Swarm deployments with automatic proxy configuration and network scanning.

    • Managing Destinations: Manage Coolify destinations including editing, deleting, resource assignment, and connecting service stacks to predefined Docker networks.

    • Resources

    • Environment Variables: Manage build-time and runtime environment variables in Coolify with team, project, and environment-based shared variables plus predefined system values.

    • Persistent Storage: Configure persistent Docker volumes and bind mounts for Coolify resources to preserve data between deployments with proper path mapping and sharing options.

    • Drain Logs: Stream Coolify application logs to Axiom, New Relic, or custom FluentBit destinations for centralized monitoring and log analysis.

    • Rolling updates: Deploy zero-downtime application updates with Coolify rolling updates using health checks, default container naming, and graceful container transitions.

    • Health checks: Configure application health checks in Coolify with Dockerfile or UI settings for Traefik routing, rolling updates, and troubleshooting 404 errors.

    • Node.js Multi-Core Scaling: Scale a Node.js, Bun, or Deno application across all available CPU cores using PM2 cluster mode or SO_REUSEPORT, with Dockerfile and Nixpacks examples for Coolify.

    • Supported Cron Syntax: Complete cron syntax reference for Coolify scheduled tasks including standard format and predefined schedules like hourly, daily, and weekly.

    • How-Tos

      • Migrate Applications: Step-by-step guide to migrate applications, databases, and Docker volumes from one Coolify server to another with backup and restore scripts
      • Backup and Restore Coolify: Backup and restore your Coolify instance with S3 or manual methods including database migration, SSH key transfer, and APP_KEY configuration.
      • Load Balancing on Hetzner: Deploy scalable load-balanced applications on Hetzner Cloud with Coolify including TLS termination, health checks, database setup, and firewall configuration.
      • Using WordPress Multisite with Coolify: Configure WordPress Multisite in Coolify with subdomain or subdirectory setup, persistent storage, and network configuration
      • Raspberry Pi OS Setup Guide: Install Coolify on Raspberry Pi with 64-bit OS setup guide covering Pi Zero 2 W, Pi 3, 4, and 5 models with SSH configuration.
      • macOS using Colima Setup Guide: Install Coolify on macOS using a Colima virtual machine with Docker, covering VM creation, networking, and SSH configuration.
      • Private NPM Registry: Use private NPM registries with Coolify deployments by configuring .npmrc authentication tokens and build environment variables.
      • Ollama with GPU: Self-host Ollama LLM with NVIDIA GPU acceleration on Coolify including hardware requirements, Docker configuration, and model management setup.
      • Deploy Webstudio Projects to Hetzner with Coolify: Complete guide to deploying Webstudio projects with Coolify on Hetzner servers using Docker, GitHub integration, and automated deployment.

    • Servers

      • Introduction: Connect localhost and remote Linux servers to Coolify with SSH authentication, Docker Engine, wildcard domains, and Traefik proxy setup.
      • Automated Docker Cleanup: Prevent disk space issues with Coolify's automated Docker cleanup removing stopped containers, unused images, build cache, and volumes on schedule or threshold.
      • Build Server: Set up a build server in Coolify to separate your build process from deployment, reduce load, and improve performance.
      • Firewall: Configure firewall ports for Coolify including SSH, HTTP/HTTPS, dashboard access, and terminal with ufw-docker setup for self-hosted and cloud instances.
      • Multiple Servers: Deploy applications across multiple servers with Coolify for high availability using Docker Registry, load balancers, and synchronized deployments.
      • Sentinel and Metrics: Monitor server and container CPU and RAM usage with Coolify's lightweight Sentinel container providing Linux API and resource metrics collection.
      • Non-root user: Configure Coolify servers with non-root users using SSH keys and passwordless sudo permissions for secure resource management.
      • OpenSSH: Configure OpenSSH server for Coolify with key-based authentication, proper permissions, and automated SSH setup across Ubuntu, Debian, CentOS, and Alpine Linux.
      • Oracle Cloud: Configure Oracle Cloud free ARM servers with Coolify including root user setup, SSH configuration, firewall rules, and non-root user permissions.
      • Supported Proxy: Learn about Traefik and Caddy reverse proxy support in Coolify for routing traffic, SSL certificates, and load balancing with switching guide
      • Server Patching: Update server packages from Coolify dashboard with APT, DNF, and Zypper support including individual or batch updates and weekly notifications.
      • Terminal Access: Manage terminal access for servers and containers in Coolify with admin-level controls and security permissions.

    • S3

      • Introduction: Configure S3-compatible storage for Coolify backups including AWS, DigitalOcean Spaces, MinIO, Cloudflare R2, Supabase Storage, Backblaze B2, and Scaleway Object Storage.
      • Aws S3 Backup Setup: Set up automated Coolify backups with AWS S3 including IAM policy creation, bucket configuration, access key setup, and cost-effective lifecycle rules.
      • Cloudflare R2: Configure Cloudflare R2 S3-compatible storage for Coolify backups with bucket creation, API token setup, and access credentials configuration.
      • Supabase Storage: Configure Supabase Storage as an S3-compatible backup destination for Coolify using your project endpoint, bucket, region, and access keys.

    • Docker

      • Docker Compose: Deploy multi-container Docker Compose stacks in Coolify with magic environment variables, persistent storage, healthchecks, and predefined network connections.
      • Custom Commands: Add custom Docker run options to Coolify deployments including custom entrypoints, GPU support, security options, system controls, devices, and resource limits.
      • Docker Registry: Push built Docker images to any registry with Coolify including custom tags, authentication setup, Swarm mode support, and self-hosted registry configuration.
      • Docker Swarm: Deploy Coolify resources across Docker Swarm clusters with external registry requirements, manager and worker setup, and persistent storage configuration.

    • Proxy

      • Traefik
        • Traefik Overview: Configure Traefik reverse proxy in Coolify with dynamic routing, SSL management, load balancing, and dashboard monitoring for containerized applications.
        • Basic Auth Middleware: Protect Coolify applications and services with Traefik basic authentication middleware using htpasswd credentials for standard and Docker Compose deployments.
        • Custom SSL Certificates: Use custom SSL certificates with Traefik proxy in Coolify including self-signed certificates, Let's Encrypt, and public CA certificates configuration.
        • Enable Dashboard: Enable and secure Traefik dashboard in Coolify with basic authentication, dynamic configuration, Let's Encrypt SSL, and custom domain access.
        • Custom Middlewares
          • Custom Middlewares: Apply custom Traefik middlewares to Coolify applications and Docker Compose services for rate limiting, IP whitelisting, custom headers, and more.
          • Redirects: Configure Traefik URL redirects in Coolify including www to non-www, domain forwarding, and HTTPS redirections for applications and services.
        • Dynamic Configurations: Configure Traefik proxy on the fly without restarts using Coolify's dynamic configuration system for real-time middleware and routing updates.
        • Load-balancing: Configure Traefik load balancing in Coolify across multiple servers or containers with dynamic configuration, HTTPS support, and health monitoring.
        • DNS Challenge: Switch Traefik from HTTP challenge to DNS challenge for ACME (Let's Encrypt) certificates — required for wildcard certs or servers without a public port 80.
        • Wildcard SSL Certificates: Issue a single Let's Encrypt wildcard SSL certificate (*.example.com) with Traefik to cover every subdomain without per-resource certificate generation.
        • Authentik Forward Authentication Middleware: Secure Coolify services with Authentik SSO forward authentication using Traefik middleware for proxy provider single sign-on protection.
      • Caddy
        • Caddy Overview: Use Caddy reverse proxy with Coolify for automatic SSL certificates, simple configuration, and HTTP/2 support as an alternative to Traefik.
        • Caddy Basic Auth: Add password protection to Coolify applications with Caddy basic authentication using hash-password CLI for secure credential management.
        • DNS Challenge: Switch Caddy from HTTP challenge to DNS challenge for ACME (Let's Encrypt) certificates — required for wildcard certs or servers without a public port 80.

    • FAQ: Common Coolify questions answered including SSH permissions, custom ports, Cloudflare SSL, concurrent builds, and application port mapping troubleshooting.

  • API Reference

  • Troubleshoot

    • Troubleshooting Overview: Comprehensive Coolify troubleshooting guides covering deployment errors, server issues, proxy problems, SSL certificates, and application configuration fixes.
    • Installation
      • Coolify Install Script Failed: Debug and fix Coolify installation script failures with step-by-step troubleshooting for logs, Docker issues, port conflicts, and container problems.
      • Docker Installation Failed: Fix Docker installation failures during Coolify setup by using Ubuntu LTS versions or manually installing Docker 24+ on non-LTS operating systems.
    • Applications
      • Bad Gateway Error: Fix Bad Gateway (502) errors in Coolify by checking port configuration, host mapping, listening addresses, and container health.
      • No Available Server Error: Fix No Available Server (503) errors in Coolify by diagnosing health checks, domain configuration, port mismatches, and Traefik proxy issues.
      • Gateway Timeout Errors: Resolve Gateway Timeout (504) errors in Coolify by fixing network isolation, adjusting proxy timeouts for Traefik, Caddy, and Nginx.
      • Failed To Get Access Token During Deployment: Fix GitHub access token errors in Coolify deployments caused by NTP time synchronization issues affecting JWT 'iat' claim validation during authentication.
    • Dashboard
      • Dashboard Inaccessible via Instance Domain: Fix Coolify dashboard access issues by checking proxy status, container health, firewall ports, and resolving domain configuration.
      • Slow Coolify Dashboard Performance: Resolve slow Coolify dashboard loading by disabling Cloudflare Rocket Loader, checking server location, and optimizing proxy settings for faster performance.
      • Disable 2FA Manually: Manually disable two-factor authentication in Coolify using SSH, Docker exec, and Laravel Tinker commands when you've lost your 2FA device or codes.
    • Docker
    • Server
      • Connection Unstable: Fix unstable Coolify server connections by removing UFW LIMIT rules, adjusting iptables, and configuring firewall settings for port 22 SSH access.
      • Server Crash During Build: Fix server crashes during Coolify builds by offloading to external build servers, using GitHub Actions, or upgrading server resources for Docker image builds.
      • 2FA Stopped Working: Fix two-factor authentication failures in Coolify by synchronizing server time with NTP, checking systemd-timesyncd, and configuring firewall port 123 access.
      • Raspberry Pi Crashes: Fix Raspberry Pi crashes on Coolify by upgrading to 4GB+ RAM or limiting Docker memory usage on 2GB models with slow SD card configurations.
      • Server Validation Issues: Resolve Coolify server validation errors by verifying SSH private key format includes BEGIN and END OPENSSH PRIVATE KEY headers to fix libcrypto errors.
    • DNS & Domains
Related
Vercel AI SDK

The AI Toolkit for TypeScript, from the creators of Next.js.

/llms.txt
136,985 tokens
Developer Tools
Mintlify

Meet the modern standard for public facing documentation. Beautiful out of the box, easy to maintain, and optimized for user engagement.

/llms.txt
5,436 tokens
/llms-full.txt
181,290 tokens
Developer Tools
Svelte

Web development for the rest of us.

/llms.txt
602 tokens
/llms-full.txt
453,623 tokens
Developer Tools
Pinecone

Search through billions of items for similar matches to any object, in milliseconds. It’s the next generation of search, an API call away.

/llms.txt
15,715 tokens
/llms-full.txt
588,629 tokens
Developer Tools
Trigger.dev

Build and deploy reliable background jobs with no timeouts and no infrastructure to manage.

/llms.txt
12,202 tokens
/llms-full.txt
387,586 tokens
Developer Tools
Turso

Get the simple developer experience of SQLite in production, and scale your multi-tenant backend with unlimited databases.

/llms.txt
10,006 tokens
/llms-full.txt
163,317 tokens
Developer Tools
Upstash

Upstash is a serverless data platform providing low latency and high scalability for real-time applications.

/llms.txt
52,307 tokens
/llms-full.txt
1,200,134 tokens
Developer Tools
Envoyer

One-click deployments built for teams, tuned for Laravel, loaded with tools and goodies you're going to love.

/llms.txt
565 tokens
/llms-full.txt
11,330 tokens
Developer Tools