---
title: Runtipi
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, deployment, app-store, docker, homelab]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Deployment, https://github.com/runtipi/runtipi]
---

# 🚀 Runtipi

> **L'app store self-hosted léger** — interface web simple, catalogue d'apps curated, déploiement en un clic, parfait pour les homelabbers qui veulent Umbrel en plus technique.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [runtipi.io](https://runtipi.io/) |
| **GitHub** | [runtipi/runtipi](https://github.com/runtipi/runtipi) |
| **License** | GPL-3.0 |
| **Langage** | TypeScript / Next.js / NestJS |
| **Étoiles GitHub** | 9 453 ⭐ |
| **Catégorie** | [[cat-deployment\|Deployment & PaaS]] |

## 📝 Description

**Runtipi** est un **app store self-hosted** qui se positionne comme **"Umbrel pour les plus techniques"** ou **"CasaOS avec un vrai catalogue"**. Lancé en 2022, le projet a atteint 9k+ étoiles en se concentrant sur un créneau précis : **offrir une expérience "un clic" pour installer des apps self-hosted**, sans la lourdeur d'un PaaS comme Coolify ou la complexité d'un Kubernetes.

Le concept est simple : **Runtipi tourne comme un container Docker** sur n'importe quel hôte (VPS, Raspberry Pi, mini-PC, NAS). L'UI web permet de **parcourir un catalogue d'environ 200 apps** (Nextcloud, Jellyfin, Vaultwarden, Pi-hole, Gitea, Immich, Paperless, Home Assistant, AdGuard, etc.), de les installer, configurer, mettre à jour, et de gérer leurs **domaines** et **backups** — le tout depuis une seule interface.

⚠️ **Différences avec Umbrel** : Runtipi **n'est pas un OS** — c'est une **application** qui tourne *sur* votre Linux. Plus léger, plus compatible avec des installations existantes (Proxmox, Debian, Ubuntu, Fedora), plus facile à intégrer dans un homelab déjà en place. **Différences avec CasaOS** : Runtipi a un **vrai système d'update pour les apps** (pas besoin de réinstaller manuellement) et un **catalogue plus large**.

**Public cible** : **homelabbers** qui veulent un app store sans réécrire leur OS, **sysadmins** qui gèrent un parc de serveurs en self-hosted, **débutants** qui trouvent Docker Compose trop verbeux. Pour un OS complet clé en main, voir [[app-umbrelos]] ; pour un PaaS orienté dev, [[app-coolify]] / [[app-dokploy]] ; pour un GUI Docker générique, [[app-yacht]].

## 🚀 Installation

### Via Docker (recommandé — 1 seule commande)

```bash
# Script d'install officiel
curl -L https://setup.runtipi.io | bash
# Ou manuellement :
git clone https://github.com/runtipi/runtipi.git
cd runtipi
docker compose up -d
# UI accessible sur http://IP:80
```

### docker-compose.yml minimal

```yaml
# docker-compose.yml
services:
  runtipi:
    image: ghcr.io/runtipi/runtipi:latest
    container_name: runtipi
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./data:/data
      - ./apps:/apps
    environment:
      - INTERNAL_IP=192.168.1.10
```

> ⚠️ **Nécessite l'accès au socket Docker** (lecture seule suffit) pour pouvoir provisionner les apps en tant que conteneurs. Isoler l'hôte en conséquence.

## ⚙️ Configuration

1. **Premier accès** : UI web sur `http://IP:80`, créer un compte admin
2. **DNS** : configurer un wildcard `*.tipi.lan` (ou `*.example.com`) pointant vers l'IP
3. **Activer HTTPS** : Settings → Domain → activer le cert auto-signé ou Let's Encrypt (DNS-01)
4. **Installer des apps** : App Store → choisir → "Install" → configurer les variables d'env
5. **Gérer les apps** : onglet "My apps" → start/stop/update, voir les logs
6. **Backups** : Settings → Backups → S3, schedule automatique, restore en un clic
7. **Domaines personnalisés** : pour chaque app, assigner `cloud.example.com` (Runtipi configure le reverse proxy)
8. **Mises à jour** : Settings → Update → Runtipi se met à jour lui-même + propose les updates d'apps

## 🔗 Alternatives

- **Umbrel** — OS complet + app store, plus "grand public", moins technique
- **CasaOS** — autre GUI simple, app store moins riche, pas d'update d'app automatique
- **Coolify** — PaaS complet avec git deploy, plus orienté développeurs
- **Dokploy** — concurrent direct de Coolify, basé sur Traefik
- **Synology DSM** — NAS propriétaire, UI très proche, plus cher
- **Portainer** — GUI Docker, pas d'app store un-click
- **Yacht** — GUI Docker léger, web UI, pas d'app store
- **Yunohost** — distro Debian + apps, plus ancien, plus "association"

## 🔒 Sécurité

- **Compte admin + 2FA** : obligatoire dès l'install
- **Ne pas exposer le port 80/443** sans reverse proxy (Caddy/Authelia) devant
- **Mises à jour régulières** : Runtipi publie souvent, ne pas différer
- **Backup du dossier** `./data` (état Runtipi) + `./apps` (données apps)
- **Limiter les permissions** : Runtipi a accès au socket Docker → un hôte dédié est recommandé
- **DNS-01 challenge** : préféré à HTTP-01 (marche derrière NAT, pas besoin d'ouvrir le 80)

## 📚 Ressources

- [Documentation officielle](https://docs.runtipi.io/)
- [Dépôt GitHub runtipi/runtipi](https://github.com/runtipi/runtipi)
- [App Store Runtipi](https://runtipi.io/apps)
- [Communauté Discord](https://discord.gg/Bu9qEPnH9V)
- [Runtipi vs CasaOS (Reddit)](https://www.reddit.com/r/selfhosted/)

## 🔗 Pages Liées

- [[cat-deployment]]
- [[app-umbrelos]]
- [[app-coolify]]
- [[app-dokploy]]
- [[app-yacht]]
- [[cat-docker]]
- [[securisation-home-lab]]
- [[recettes-docker-compose]]
