Installing Coolify on Raspberry Pi as a Home Server

Hardware Preparation

• Raspberry Pi: Ensure your Raspberry Pi is correctly configured and connected to the network.
• Power Adapter: Provide a stable power supply for the Raspberry Pi.
• Storage Device: At least one microSD card is required to install the operating system.
• Network Connection: Ensure the Raspberry Pi can connect to the internet via Ethernet or Wi-Fi.

Software Preparation

• Operating System: Choose a Linux distribution suitable for Raspberry Pi, such as Raspberry Pi OS or Ubuntu Server for Raspberry Pi.
• Docker: Ensure Docker and Docker Compose are installed in the operating system.

Step-by-Step Guide

Install the Operating System

1. Download the Linux distribution image suitable for Raspberry Pi, such as Raspberry Pi OS or Ubuntu Server for Raspberry Pi.
2. Use Etcher or another image writing tool to write the image to a microSD card.
3. Insert the microSD card into the Raspberry Pi, boot it, and follow the prompts to install the operating system.

Install Docker and Docker Compose

1. Open the terminal and run the following commands to install Docker:

   curl -fsSL https://get.docker.com -o get-docker.sh
   sudo sh get-docker.sh
   

2. Install Docker Compose:

   sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   sudo chmod +x /usr/local/bin/docker-compose
   

Download Coolify's Docker Compose File

1. Create a directory to store Coolify's configuration files, for example:

   mkdir ~/coolify && cd ~/coolify
   

2. Download Coolify's Docker Compose file:

   curl -o docker-compose.yml https://raw.githubusercontent.com/coollabsio/coolify/main/docker-compose.yml
   

Configure Environment Variables

1. Create a .env file and add necessary environment variables:

   touch .env
   nano .env
   

2. Add the following content to the .env file:

   COOLIFY_APP_ID=your-app-id
   COOLIFY_SECRET_KEY=your-secret-key
   COOLIFY_DATABASE_URL=sqlite:////data/coolify.db
   COOLIFY_HOST=http://your-server-ip:3000
   

Start Coolify

1. In the directory containing the docker-compose.yml and .env files, run the following command to start Coolify:

   docker-compose up -d
   

Access Coolify

1. Once started, you can access Coolify's web interface via a browser at http://your-server-ip:3000.