System Requirements
- Hardware: A VPS with at least 2 vCPU, 2GB RAM (4GB+ recommended for production use).
- Operating System: Ubuntu 22.04 / 24.04 (officially supported), Debian, or another Docker-compatible Linux distribution.
- Permissions: Root or full
sudoaccess. - Networking: A domain name (optional but highly recommended for SSL setup and easier client access).
Installation
- 1 Connect to Server: SSH into your server as
rootor a user withsudoprivileges. - 2 Run the Installation Script: Execute the official, one-line installation script below:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
The installer automatically handles Docker dependencies, pulls the required Coolify containers, and configures the initial system environment.
- 3 Access the Dashboard: Once completed, open your web browser and navigate to:
http://your-server-ip:8000
- 4 Admin Onboarding: Create your primary administrator account on your first visit. This is a one-time setup screen—ensure you complete it immediately following installation to secure your dashboard.
Initial Configuration
- Public URL Setup: Under Settings, configure your instance’s public URL. This is critical for generating correct webhooks and link redirections once you attach a production domain.
- SSH Keys: Add deployment keys under Keys & Tokens if you plan to orchestrate and deploy applications onto secondary remote servers from this centralized Coolify console.
- Server Validation: Under Servers, verify that your
localhostengine displays a validated green checkmark. This confirms that Coolify can successfully deploy apps directly to its host server.
⚠️ Resource Budgeting Note
While the Coolify control panel itself is incredibly lightweight, keep in mind that it shares resources directly with the live Docker apps, stacks, and databases you deploy. Ensure you plan your infrastructure dimensions and scale your virtual environment according to your total application workloads.
