Back to posts
How to install coolify

How to install coolify

Fredy Acuna / October 29, 2024 / 2 min read

Coolify Self-Hosted Installation Guide

Prerequisites

Before installing Coolify, ensure you have the following:

  • A Linux-based server (Ubuntu 20.04 or higher is recommended).
  • Docker and Docker Compose installed.
  • A domain name for your Coolify instance (optional but recommended).

Step 1: Install Docker

If Docker is not installed, you can install it using the following commands:

sudo apt update
sudo apt install -y docker.io
sudo systemctl enable --now docker

Verify that Docker is running:

sudo docker --version

Step 2: Install Docker Compose

Install Docker Compose using this command:

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verify the installation:

docker-compose --version

Step 3: Clone the Coolify Repository

Clone the Coolify repository from GitHub:

git clone https://github.com/coollabsio/coolify.git
cd coolify

Step 4: Configure Environment Variables

Copy the .env file and make necessary adjustments:

cp .env.example .env

Modify the .env file to match your server and domain settings.

Step 5: Start Coolify

Start Coolify using Docker Compose:

docker-compose up -d

Coolify will now start in the background.

Step 6: Access Coolify

Once Coolify is up and running, you can access it via your domain or server IP address on port 3000. For example:

http://your-domain-or-ip:3000

Step 7: Set Up SSL (Optional)

To set up SSL using Let's Encrypt, update your .env file with your domain name and enable the ENABLE_SSL option.

Then, restart Coolify:

docker-compose down
docker-compose up -d

You should now have Coolify running with SSL enabled.


That's it! You have successfully installed Coolify in self-hosted mode. For further configurations and detailed usage, refer to the official documentation.

Subscribe to my newsletter

Get updates on my work and projects.

We care about your data. Read our privacy policy.