# Runtipi — Self-Hosted Home Server App Manager

> A personal home server manager that lets you install and manage dozens of self-hosted apps with one click, backed by Docker Compose and a clean web dashboard.

## Install

Save as a script file and run:

# Runtipi — Self-Hosted Home Server App Manager

## Quick Use
```bash
curl -L https://setup.runtipi.io | bash
# Open http://<server-ip>:80 to access the dashboard
```

## 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

---
Source: https://tokrepo.com/en/workflows/f3e74ec0-3e02-11f1-9bc6-00163e2b0d79
Author: Script Depot