Raspberry Pi OS Setup Guide
Prerequisites
To run Coolify on a Raspberry Pi, you will need one of the following Raspberry Pi models:
- Raspberry Pi Zero 2 W
- Raspberry Pi 400
- Raspberry Pi 3 (all models)
- Raspberry Pi 4 (all models)
- Raspberry Pi 5 (all models)
Installation
-
Download and install the Raspberry Pi Imager on your computer.
-
Insert your microSD card into your computer's card reader.
-
Open Raspberry Pi Imager and select your device:
- Click
Choose Device - Select your Raspberry Pi model
- Click
-
Select the Operating System:
- Click
Choose OS - Navigate to
Raspberry Pi OS (other) - Select
Raspberry Pi OS Lite (64-bit)
- Click
Caution
You must select one of the 64-bit OS versions as Coolify is not compatible with 32-bit versions.
Note
While you can use the full desktop version Raspberry Pi OS (64-bit)/Raspberry Pi OS Full (64-bit) or even Ubuntu, we recommend the Raspberry Pi OS Lite version as it uses fewer resources.
-
Choose your Storage:
- Click
Choose Storage - Select your microSD card
- Double-check you've selected the correct drive to avoid data loss
- Click
-
Click
Nextand selectEdit settingsfor OS Customization.- Navigate to
Servicesand enable SSH with a public key.
- Navigate to
Caution
The SSH key must not have a passphrase or 2FA enabled, otherwise you will not be able to complete the onboarding process.
- Configure other options as needed
-
Finish the installation onto the SD card.
-
Once complete, insert the microSD card into your Raspberry Pi and power it on.
-
After your Raspberry Pi boots up, proceed with the Coolify installation.
Using WordPress Multisite with Coolify
Configure WordPress Multisite in Coolify with subdomain or subdirectory setup, persistent storage, and network configuration
macOS using Colima Setup Guide
Install Coolify on macOS using a Colima virtual machine with Docker, covering VM creation, networking, and SSH configuration.