Back to posts
How to install coolify

How to install coolify

Fredy Acuna / October 29, 2024

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.