Homarr on Raspberry Pi

🔍 Key Features

• Drag-and-drop layout: Rearrange tiles and widgets effortlessly without editing YAML or JSON.
• Over 30 integrations: Connects with apps like Jellyfin, Overseerr, SABnzbd, and Home Assistant.
• 10,000+ built-in icons: Pulls from multiple repositories for crisp, recognizable app visuals.
• Authentication out of the box: Supports user login and access control without extra setup.
• Live status and controls: View app health, media progress, and trigger actions directly from the dashboard.
• Mobile-friendly interface: Fully responsive and touch-optimized for tablets and phones.
• No-code configuration: Everything is managed through the UI — no terminal or config files required.

🚀 Docker Installation Steps

1. Update your system
   sudo apt update && sudo apt upgrade -y
2. Install Docker
   

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

3. Install Docker Compose
   sudo apt install docker-compose-plugin
4. Add your user to the Docker group
   sudo usermod -aG docker $USER
5. Enable Docker at boot
   sudo systemctl enable docker
6. Reboot
   sudo reboot
7. Test Docker
   docker run hello-world

📁 Setup Homarr

mkdir ~/docker
mkdir ~/docker/homarr 

🧾 Docker Compose File

In ~/docker/homarr create docker-compose.yml

  services:
  homarr:
    container_name: homarr
    image: ghcr.io/homarr-labs/homarr:latest
    platform: linux/arm64
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # Optional, only if you want docker integration
      - ./homarr/appdata:/appdata
    environment:
      - SECRET_ENCRYPTION_KEY=fb689cb18133a07f24c10f7550c894e0be7bbfcb76405b90d55aca7d47276c1f
    ports:
      - '7575:7575' 

▶️ Start Homarr

From within ~/docker/homarr run:

You should get an email from Watchtower pretty quickly.

📜 View Logs

Create an integration

I'll walk through creating integrations for qBittorrent, Plex, and pihole

Start by clicking on your initials in the upper righ-hand corner (in my case, JR)

Now click on Management

Click on Integrations

Click on New Integration and select qBittorrent

This screen will open. Fill in the URL (ex. http://192.186.xx.xx:8080), Username for qBittorent, and Password. Click on "Test connection and create"

Now go to your board and click on the pencil in the upper righthand corner and click on the +.

Click on New item.

Click on Download Client.

Click on the three dots.

Select qBittorrent in the Integrations field and click on Save changes. You should now see something like this on your board.

Repeat the above steps for Plex. For Plex, you'll need an API Token. You get that by browsing to your Plex server. Open Developer Tools. Go to the Network tab and search for X-Plex-Token. Open one of the packets and copy the value for X-Plex-Token. It will look something like 5QM_-NtXu_eEBjsVqrwo.

Repeat the above steps for pihole. You'll also need an API Token. You get that by browsing to your pihole server, click on Settings, Web Interface/API. Click on Configure app password and the copy the password. Use that for your API Token. ,/p>