# 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="/files/qeAFqc1vGYlrFxbv0iuo" 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="/files/Llv9x1wKIS23LPxt7Hmy" 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="/files/Ildw2b5totxXhjQtX5RC" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/enl4FIR1b5HsmcxjS46C" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/uanecTCO2Iq3XO3UpfFe" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7ct0AQpsVnrDjqnYmQhg" 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="/files/IqnuDnFeQQ9ngKEmxQLK" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.neevcloud.com/neevcloud-guide/neevcloud-knowledgebase/installation-and-configuration-of-coolify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.