Runtipi — Self-Hosted Home Server App Manager

Introduction

Runtipi is an open-source home server manager that simplifies running self-hosted applications. Instead of manually writing Docker Compose files for each service, Runtipi provides a one-click app store with a web dashboard to install, update, and manage everything from Nextcloud to Jellyfin on your own hardware.

What Runtipi Does

• Provides a curated app store with 200+ pre-packaged self-hosted applications
• Manages Docker containers behind the scenes with automatic networking and volumes
• Exposes a web dashboard for installing, updating, starting, and stopping apps
• Handles reverse proxy and optional SSL certificates for each app
• Supports custom app definitions for adding your own Docker Compose services

Architecture Overview

Runtipi is a Node.js application that orchestrates Docker Compose stacks on the host machine. Each app is defined as a template with a Docker Compose file and metadata. The dashboard is a Next.js frontend that communicates with a backend worker process. Traefik runs as a built-in reverse proxy to route traffic to each app by subdomain or path.

Self-Hosting & Configuration

• Install with the one-line script: curl -L https://setup.runtipi.io | bash
• Requires a Linux system with Docker already installed or the installer handles it
• Configure domain and DNS settings in the dashboard for HTTPS with automatic Let's Encrypt
• Set environment variables in settings.json or through the web UI
• Custom apps can be added by placing a Docker Compose template in the user apps directory

Key Features

• One-click install for 200+ self-hosted apps from a maintained catalog
• Automatic updates with rollback support for installed applications
• Built-in Traefik reverse proxy with automatic SSL certificate provisioning
• Multi-user support with separate permissions for managing apps
• Guest dashboard mode for exposing select apps to household members

Comparison with Similar Tools

• CasaOS — similar concept with a polished UI; Runtipi offers a larger app catalog and Traefik integration
• Umbrel — originally Bitcoin-focused; Runtipi is purpose-built for general self-hosting
• Portainer — lower-level container management; Runtipi provides app-store simplicity
• YunoHost — Debian-based with its own package format; Runtipi uses standard Docker Compose
• Coolify — focused on deploying custom apps and PaaS; Runtipi is for curated one-click installs

FAQ

Q: What hardware do I need to run Runtipi? A: Any Linux machine with 2 GB RAM and Docker support. A Raspberry Pi 4, old laptop, or cheap VPS all work.

Q: Can I use my own Docker Compose apps? A: Yes. Place a custom app definition in the user-config/apps directory and it appears in the dashboard alongside catalog apps.

Q: How are updates handled? A: The dashboard shows available updates. You click update, and Runtipi pulls the new image and recreates the container with your existing data volumes preserved.

Q: Does Runtipi support ARM devices? A: Yes. Most catalog apps provide multi-architecture images that run on ARM64 devices like the Raspberry Pi 4 and 5.

Sources

• https://github.com/runtipi/runtipi
• https://runtipi.io/docs/getting-started