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
  1. Raspberry Pi 4 with at least 2GB RAM
  2. Raspberry Pi OS Lite (64-bit) — minimal, no desktop
  3. 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.