> For the complete documentation index, see [llms.txt](https://docs.neevcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neevcloud.com/neevcloud-guide/neevcloud-knowledgebase/installation-and-configuration-of-coolify.md).

# Installation and Configuration of Coolify

#### **Introduction**

Coolify is an open-source PaaS (Platform as a Service) used to deploy applications, databases, and services without writing Kubernetes or Docker commands manually.\
This document describes step-by-step installation and configuration of Coolify on Ubuntu 22.04.

***

**step 1: System Requirements**

| Component | Requirement                     |
| --------- | ------------------------------- |
| OS        | Ubuntu Server 22.04             |
| RAM       | Minimum 2 GB (recommended 4 GB) |
| CPU       | Minimum 2 vCPU                  |
| Storage   | 20 GB free                      |
| Network   | Public or private IP            |

***

**step 2: Pre-Installation Steps**

**2.1 Update the System**\
\
Before installing Coolify, it is essential to update the server to ensure all system packages, security patches, and repositories are up to date. This helps prevent compatibility issues during installation.

```bash
sudo apt update && sudo apt upgrade -y
```

**2.2 Install Required Packages**

```bash
sudo apt install -y curl ca-certificates gnupg lsb-release ufw
```

***

**step 3: Install Coolify (Official Method)**

Coolify provides an official installation script.

**3.1 Run the Installer**

```bash
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
```

This script automatically:

* Installs Docker & Docker Compose
* Creates the `/data/coolify` directory
* Generates the `.env` configuration file
* Starts Coolify containers
* Exposes Coolify on port **8000**\
  \
  After running the Coolify installation script, the following message will appear on the screen. It indicates that the script is automatically performing all required tasks for installation<br>

  <figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FXIBGhRzZ8zrmegrS25l6%2Fimage.png?alt=media&amp;token=316be48a-8d75-421e-81be-8f63a3bb6fa5" alt=""><figcaption></figcaption></figure>

***

**step 4: Verify Installation**

**Check Running Containers**

```bash
sudo docker ps
```

You should see containers:

* `coolify`
* `coolify-redis`
* `coolify-db`
* `coolify-realtime`
* `coolify-sentinel`

***

**step 5: Firewall Configuration (UFW)**

Allow required ports:

```bash
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp     # Allow HTTP traffic
sudo ufw allow 443/tcp    # Allow HTTPS traffic
sudo ufw allow 8000/tcp
sudo ufw allow 8443/tcp
sudo ufw reload
```

***

**step 6: Access Coolify Dashboard**

After the installation process is completed, the installer will display several URLs on the screen. \
These URLs include:

```
http://<public-ip>:8000
```

**6.1 Open the Coolify Dashboard**

Identify the **Public IP** or **Private IP** shown by the installer and open the URL in your web browser.\
This URL provides access to the Coolify web dashboard.\
\
**6.2 Create the Admin (Root) Account**

When the dashboard loads for the first time, Coolify will prompt you to create a **Root User**. This user will have full administrative access to the platform.\ <br>

<div align="center"><figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FOCHR1VrPnZvKzYSEyUTJ%2Fimage.png?alt=media&amp;token=7e4e8bf5-d782-46e3-bdaf-f57d2d762691" alt=""><figcaption></figcaption></figure></div>

**6.3 Complete the Initial Setup**

After creating the Root User:

* You may be asked to choose the **Server Type**\
  Select **"This Machine"** if you want to deploy apps on the same server where Coolify is installed.
* Optionally configure **Git Provider** (GitHub, GitLab, Bitbucket).\
  You may skip this step and configure it later if not required immediately.

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FCQF3NMal9Q9zHXmKfQc2%2Fimage.png?alt=media&amp;token=08b8c886-f20b-48be-bb3b-6639dd9708e6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FGpBMTcLgRzvwNK0c1ryC%2Fimage.png?alt=media&amp;token=6a1ab0b6-cb0f-4c48-b275-603d1c7bbad1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2F9q8hMU4k7ysK3i4JUNYW%2Fimage.png?alt=media&amp;token=3321bcfb-5145-4eab-a33a-402ff4b9ed47" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FlgAFSlH7mgmRzZraGwR9%2Fimage.png?alt=media&amp;token=f9bb34c3-f06d-450a-97c4-8f233e88d780" alt=""><figcaption></figcaption></figure>

**6.4 Access the Final Dashboard**

Once the setup is completed, Coolify will automatically redirect you to the **Main Dashboard**, where you can:

* View server health
* Deploy applications
* Create databases
* Connect Git repositories
* Access logs and activities
* Manage users and settings

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FGAl0J7yBKT40yWJ4N9wc%2Fimage.png?alt=media&amp;token=53f30131-62e9-467c-9efc-31e06285e36b" alt=""><figcaption></figcaption></figure>
