Installation #

Minimum Requirements #

Coolify builds images in two places.

Local server with Local Docker Engine (the server you installed Coolify on).

Remote Server with Remote Docker Engine (the server you added as a Destination)

The server you are building on requires at least:

• 2 CPUs
• 2 GBs memory
• 30+ GB of storage for the images.

This is for building and storing images.

If you would like to host applications/databases/services, you will need more hardware resources.

Both AMD64 and ARM architecture are supported.

Supported Operating Systems #

Currently, only Ubuntu servers are supported. If you would like to have other, please consider open an issue on GitHub.

Automatically Install #

Automated #

Questions asked, but it is not that complicated, trust me.

wget -q https://get.coollabs.io/coolify/install.sh -O install.sh; sudo bash ./install.sh

Scripted / fully automated #

No questions asked.

Could be used to install Coolify programmatically.

wget -q https://get.coollabs.io/coolify/install.sh -O install.sh; sudo bash ./install.sh -f

Configuration options #

Usage: install.sh [options...]
    -h, --help                  Show this help menu.
    -v, --version               Show script version.

    -d, --debug                 Show debug logs during installation.
    -f, --force                 Force installation, no questions asked.

    -r, --restart               Only restart Coolify. Nothing more.

    -n, --do-not-track          Opt-out of telemetry. You can set export DO_NOT_TRACK=1 in advance.

    -a, --auto-update           Warning: TESTING PHASE, DO NOT USE IT YET! Enable auto update feature of Coolify.

    -w, --white-labeled         Install white-labeled version. Contact me before using it (https://docs.coollabs.io/contact)
    -i, --white-labeled-logo    Add your remote logo for your white-labeled version. Should be a http/https URL.

Manually Install #

1. Need to set the required environment variables in a .env file (see below)
2. Need to have Docker Engine v20.10+ installed on your server.

Environment Variables #

Coolify needs to have the following environment variables to be set in advance.

This is done automatically with the automated installation script.

COOLIFY_APP_ID=
COOLIFY_SECRET_KEY=
COOLIFY_DATABASE_URL=file:../db/prod.db
COOLIFY_SENTRY_DSN=https://9e7a74326f29422584d2d0bebdc8b7d3@o1082494.ingest.sentry.io/6091062
COOLIFY_IS_ON=docker
COOLIFY_WHITE_LABELED=false
COOLIFY_WHITE_LABELED_ICON=
COOLIFY_AUTO_UPDATE=false

Restart #

wget -q https://get.coollabs.io/coolify/install.sh -O install.sh; sudo bash ./install.sh -r

Manually Start #

docker run -tid --env-file .env -v /var/run/docker.sock:/var/run/docker.sock -v coolify-db-sqlite coollabsio/coolify:latest /bin/sh -c "env | grep COOLIFY > .env && docker compose up -d --force-recreate"

Why is this complicated command instead of just a docker compose up?

Coolify needs to be started inside docker's namespace.

In short, it is necessary for the auto-update process.

Change Configuration #

You can always execute the installation script with different options to reconfigure Coolify.

For example:

• If you want to opt-out of tracking, execute the install script with --do-not-track.
• If you want to use the white-labeled version, execute the install script with --white-labeled.

Firewall settings #

You need to allow the following ports in your firewall:

• 80, 443 -> For Coolify Proxy (if you are using it)
• 3000 -> For Coolify itself mandatory
• 9000-9100 -> For TCP/HTTP on-demand proxies. You can specify different range in the Settings menu.