124 lines
5.2 KiB
Markdown
124 lines
5.2 KiB
Markdown
---
|
|
title: DockSTARTer
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, deployment, docker, scripts, homelab, bash]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Deployment, https://github.com/GhostWriters/DockSTARTer]
|
|
---
|
|
|
|
# 🚀 DockSTARTer
|
|
|
|
> **Scripts shell de provisioning Docker pour home servers** — déployez une stack domotique/média complète sur un Raspberry Pi ou un NUC en quelques commandes, sans maîtriser docker-compose.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [dockstarter.com](https://dockstarter.com/) |
|
|
| **GitHub** | [GhostWriters/DockSTARTer](https://github.com/GhostWriters/DockSTARTer) |
|
|
| **License** | MIT |
|
|
| **Langage** | Bash |
|
|
| **Étoiles GitHub** | 2,6k ⭐ |
|
|
| **Catégorie** | [[cat-deployment\|Deployment]] |
|
|
| **Cible** | Homelab, Raspberry Pi, mini-serveur familial |
|
|
|
|
## 📝 Description
|
|
|
|
**DockSTARTer** est un **ensemble de scripts Bash** qui automatisent l'installation et la configuration d'une stack Docker complète sur une machine Linux nue (typiquement Debian, Ubuntu, ou Raspberry Pi OS). L'objectif est de fournir un équivalent Linux de "Synology" pour les bricoleurs : on installe l'OS, on lance DockSTARTer, on choisit ses apps, et tout est déployé.
|
|
|
|
L'approche est à l'ancienne (Bash + menus `whiptail`) par rapport aux outils web modernes ([[app-coolify]], [[app-portainer]]), mais reste pertinente pour :
|
|
|
|
- Les **Raspberry Pi** où l'on veut minimiser la RAM consommée (pas de navigateur, pas d'UI web à charger)
|
|
- Les configurations **figées sur 5 ans** : une fois configuré, on n'y touche plus
|
|
- Les **personnes allergiques au YAML** : DockSTARTer génère le compose via un menu texte
|
|
|
|
**Apps supportées** (~150) : Plex, Jellyfin, Sonarr, Radarr, Lidarr, Prowlarr, Bazarr, qBittorrent, Transmission, Pi-hole, Heimdall, Portainer, Home Assistant, Mosquitto, Node-RED, Nextcloud, Syncthing, Jellyfin, Nginx Proxy Manager, WireGuard, OpenVPN, etc.
|
|
|
|
**Fonctionnement** :
|
|
|
|
1. Le script `main.sh` clone la config dans `~/.docker`
|
|
2. Il génère un `docker-compose.yml` global basé sur les apps cochées
|
|
3. Il crée les dossiers `/home/{user}/.docker/configs/<app>/` pour les configs persistantes
|
|
4. Il (re)lance `docker compose up -d` pour tout démarrer
|
|
5. Des alias Bash (`ds`, `dcu`, `dcd`, `dcp`, `dcup`) facilitent la maintenance
|
|
|
|
**Limites** : pas d'UI web (terminal only), pas de gestion fine des ressources, pas de multi-host. Pour ces usages, se tourner vers des solutions plus récentes ([[app-coolify]], [[app-cosmos]]).
|
|
|
|
## 🚀 Installation
|
|
|
|
### Prérequis
|
|
- Linux (Debian 11+, Ubuntu 22.04+, Raspberry Pi OS, Fedora, CentOS, Arch)
|
|
- `git`, `curl` installés
|
|
- Accès sudo
|
|
|
|
### Installation one-liner
|
|
|
|
```bash
|
|
# Télécharge et lance le script
|
|
bash -c "$(curl -fsSL https://get.dockstarter.com)"
|
|
```
|
|
|
|
L'utilisateur est ensuite guidé par un menu texte pour :
|
|
|
|
- Sélectionner les apps à déployer
|
|
- Configurer le timezone, l'utilisateur PUID/PGID
|
|
- Choisir le réseau (bridge par défaut, ou macvlan)
|
|
- Lancer le déploiement
|
|
|
|
### Installation manuelle (debug)
|
|
|
|
```bash
|
|
git clone https://github.com/GhostWriters/DockSTARTer.git
|
|
cd DockSTARTer
|
|
bash main.sh
|
|
```
|
|
|
|
## ⚙️ Configuration
|
|
|
|
- **Fichier central** : `~/.docker/configs/compose/.env` contient les variables d'environnement (paths, PUID, PGID, TZ)
|
|
- **Override local** : `~/.docker/configs/compose/compose.override.yml` pour customiser un service sans modifier le compose auto-généré
|
|
- **Aliases utiles** :
|
|
- `ds` : relancer le menu principal
|
|
- `dcu` : `docker compose up -d`
|
|
- `dcd` : `docker compose down`
|
|
- `dcp` : `docker compose pull`
|
|
- `dcup` : `docker compose up -d --build`
|
|
- **Mises à jour** : `ds -u` met à jour DockSTARTer et propose d'upgrader les images
|
|
- **Backups** : DockSTARTer ne gère pas les backups ; utiliser [[app-borg-backup-server]] ou `restic`
|
|
|
|
## 🔗 Alternatives
|
|
|
|
- **[[app-coolify]]** — PaaS Docker avec UI web moderne, plus accessible
|
|
- **[[app-portainer]]** — UI web de management Docker, plus polyvalent
|
|
- **[[app-cosmos]] / CasaOS** — autre approche "stack complète" orientée grand public
|
|
- **YunoHost** — distribution serveur complète, autre philosophie
|
|
- **Docker Compose manuel** — plus de contrôle, mais plus de YAML à maintenir
|
|
|
|
## 🔒 Sécurité
|
|
|
|
- ⚠️ **Changer le port SSH** (22 → autre) avant d'exposer le serveur sur Internet
|
|
- **Fail2ban** : installer manuellement (`apt install fail2ban`) sur SSH et sur les services Docker exposés
|
|
- **Reverse proxy** : ne pas exposer Plex/Jellyfin/etc. directement ; passer par Nginx Proxy Manager ou Traefik avec TLS
|
|
- **PUID/PGID** : DockSTARTer configure un utilisateur dédié pour les conteneurs (sécurité) — ne pas le faire tourner en root
|
|
- **Updates régulières** : `ds -u` au moins une fois par mois
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Site officiel](https://dockstarter.com/)
|
|
- [Dépôt GitHub](https://github.com/GhostWriters/DockSTARTer)
|
|
- [Wiki communautaire](https://github.com/GhostWriters/DockSTARTer/wiki)
|
|
- [Subreddit r/DockSTARTer](https://www.reddit.com/r/DockSTARTer/)
|
|
|
|
## 🔗 Pages Liées
|
|
|
|
- [[cat-deployment]]
|
|
- [[app-portainer]]
|
|
- [[app-traefik]]
|
|
- [[app-coolify]]
|
|
- [[cat-docker]]
|
|
- [[securisation-home-lab]]
|
|
- [[recettes-docker-compose]]
|