wiki/Catalogue-Self-Hosted/apps/app-dockstarter.md

---

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
GitHub	GhostWriters/DockSTARTer
License	MIT
Langage	Bash
Étoiles GitHub	2,6k ⭐
Catégorie	cat-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

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

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
• Dépôt GitHub
• Wiki communautaire
• Subreddit r/DockSTARTer

🔗 Pages Liées

• cat-deployment
• app-portainer
• app-traefik
• app-coolify
• cat-docker
• securisation-home-lab
• recettes-docker-compose