Coolify notes

Install and Setup

To get started, ssh into your server and run:

1. Install following the official documentation
   curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

2. Add your current user to the Docker group, so you have permission to run docker commands. Note you will need to log out for changes to take effect.
   sudo usermod -aG docker $USER

Configure swap

On a small VM, extra swap can stop builds from running out of memory. The Debian installer usually creates a swap partition already. Check what is active:

sudo swapon --show

Example output when a swap partition is already enabled:

NAME           TYPE      SIZE USED PRIO
/dev/nvme0n1p3 partition  24G   0B   -2

If you need more swap or none is listed, follow Swap on the Debian Wiki for sizing, creating a swap file, /etc/fstab, and troubleshooting.

Usage with OrbStack

I use OrbStack for running VMs on Apple Silicon.

Quick Reference

• SSH command: ssh coolify@orb
• Coolify UI: http://coolify.orb.local:8000

Setup

1. Create a new VM with the following settings:
   • Name: coolify (this name will map to the domain name of the VM)
   • Distribution: Debian
   • Version: stable (e.g. the latest non-testing version)
   • CPU Type: arm64
2. Once the machine is created, double click it in OrbStack to open a Terminal window
3. Install Coolify using the instructions from their website
4. Go to http://coolify.orb.local:8000 in a browser
5. Complete the setup as normal, registering the account, etc.

Once logged into the Coolify UI, make the following changes:

1. Disable the Proxy, as it doesn't work with mDNS
   • Go to Servers > localhost > Proxy
   • Click the "Switch Proxy" button (right of the Configuration heading)
   • Choose "None"