À propos du projet

Proxmox VE Helper-Scripts (Community Edition) est une collection de scripts d'automatisation maintenus par la communauté qui installent et configurent des services auto-hébergés sur Proxmox VE. Au lieu de chercher manuellement les paquets et de modifier les fichiers de configuration, les utilisateurs collent une seule commande dans le shell Proxmox, répondent à quelques questions et se retrouvent avec un conteneur ou une machine virtuelle fonctionnel. Le projet est présenté comme une continuation communautaire fondée sur le travail original de tteck, et est maintenu par une petite équipe centrale ainsi que par des contributeurs externes. Les scripts sont sous licence MIT, ce qui permet de les utiliser, les modifier et les redistribuer à des fins personnelles et commerciales. Exigences - Proxmox VE version 8.4, 9.0, 9.1 ou 9.2 (un hôte Proxmox basé sur Debian). - Accès au shell root sur l'hôte Proxmox. - Une connexion Internet pendant l'installation. Pour commencer 1. Parcourez le site du projet pour trouver le service souhaité, par exemple Home Assistant, Nginx Proxy Manager ou Jellyfin. 2. Copiez la commande d'installation en une ligne affichée sur la page de ce script. 3. Ouvrez le shell Proxmox et collez la commande. 4. Choisissez le mode d'installation Default ou Advanced et suivez les instructions. Chaque page de script est documentée avec le contenu du conteneur, son allocation de ressources par défaut et les notes post-installation. Comportement des scripts Le mode Default sélectionne des valeurs par défaut raisonnables pour le CPU, la RAM et le stockage, et ne pose que les questions strictement nécessaires, la plupart des installations étant déclarées comme terminées en moins de cinq minutes. Le mode Advanced expose les paramètres du conteneur, le réseau, les backends de stockage et la configuration au niveau de l'application avant toute installation. Après l'installation, chaque conteneur inclut un assistant post-installation accessible depuis le shell Proxmox, qui peut appliquer des mises à jour au service installé, modifier les paramètres de l'application sans éditer manuellement les fichiers de configuration, et fournir un dépannage basique et un accès aux logs. Étendue de la collection Le README décrit la prise en charge de centaines de services, regroupés par catégories telles que l'automatisation domestique (Home Assistant, Zigbee2MQTT, ESPHome, Node-RED), les médias (Jellyfin, Plex, Radarr, Sonarr, Immich), la gestion réseau (AdGuard Home, Nginx Proxy Manager, Pi-hole, Traefik), la surveillance (Grafana, Prometheus, Uptime Kuma, Netdata), les bases de données (PostgreSQL, MariaDB, Redis, InfluxDB), la sécurité (Vaultwarden, CrowdSec, Authentik) et les outils de développement (Gitea, Portainer, VS Code Server, n8n). Une liste complète et régulièrement mise à jour est publiée sur les pages de catégories du site du projet. Contributions Les nouveaux scripts ne sont pas acceptés directement dans ce dépôt : ils sont d'abord soumis et testés dans le dépôt séparé ProxmoxVED, et les pull requests ajoutant de nouveaux scripts ici sont fermées. Les corrections de bogues et les améliorations apportées aux scripts existants relèvent de ce dépôt et doivent suivre les directives de contribution, avec un changement focalisé par pull request et la documentation de ce que le script installe ainsi que toute décision non évidente dans le fichier métadonnées JSON correspondant. Les bogues sont signalés via le suivi des problèmes, les demandes et questions via les discussions ou le Discord du projet, et les vulnérabilités de sécurité via la politique de sécurité. Support et licence Le projet est maintenu par des bénévoles, les coûts d'infrastructure étant pris en charge personnellement ; le README indique que 30 % de tous les dons sont reversés à la recherche contre le cancer et aux soins hospices, une cause importante pour tteck. Proxmox est une marque déposée de Proxmox Server Solutions GmbH, et le code est publié sous la licence MIT.