RepoFlow Team · April 10, 2025

Deploy RepoFlow on Raspberry Pi 4

Self-Host a Private Package Registry on Raspberry Pi 4

RepoFlow is lightweight and perfect for small devices like the Raspberry Pi 4. In this guide, we’ll show you how to run RepoFlow using Docker Compose and turn your Pi into a private registry for Docker, npm, PyPI, and more.

What you need

Raspberry Pi 4 with at least 2GB RAM
Raspberry Pi OS Lite (64-bit) — minimal, no desktop
Stable network connection

Installing Docker & Docker Compose

sudo apt update && sudo apt upgrade -y

Install Docker:

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

Add your user to the docker group:

sudo usermod -aG docker $USER

Install Docker Compose plugin:

sudo apt install docker-compose-plugin -y

Deploying RepoFlow

Create all the files mentioned in the official guide

Then run:

docker compose up -d

By default, RepoFlow will be available at: http://localhost:9080

‍You can access this from the Pi itself, or configure a domain to access it from other devices:
https://docs.repoflow.io/Self-Hosting/Installation/docker-compose/changing-domain

Setting Up a License

RepoFlow requires a license to run, but don’t worry, it’s free for personal or home lab use!
You can get a free license under our self-hosted plans:
https://www.repoflow.io/pricing

‍After getting your license, just go to System Settings in RepoFlow and upload it.

Final Result

That’s it! Your Raspberry Pi 4 is now running RepoFlow, a fully featured private registry for your Docker images, npm packages, PyPI modules, and more.