Proxmox VE Helper Scripts : installer des services en un clic sur un serveur dédié

Proxmox VE Community Scripts : le projet

Proxmox VE est l'hyperviseur open source de référence pour administrer des conteneurs LXC et des machines virtuelles KVM depuis une interface web. L'installation manuelle de chaque service (Docker, reverse proxy, monitoring) demande de créer le conteneur, choisir le template, configurer le réseau, installer les dépendances et lancer le service. Proxmox VE Helper Scripts, rebaptisé Community Scripts, automatise ces étapes en une seule commande exécutée depuis le shell de l'hôte Proxmox.

Le projet a été créé en 2022 par tteck, développeur de la communauté homelab. Après son décès en novembre 2024, la communauté a repris le dépôt sous community-scripts/ProxmoxVE (licence MIT). Le dépôt dépasse aujourd'hui 29 000 étoiles sur GitHub, propose plus de 400 scripts et prend en charge Proxmox VE 8.4, 9.0, 9.1 et 9.2. Chaque script crée un conteneur LXC ou une VM préconfigurée avec le service prêt à démarrer.

Ce guide s'adresse aux administrateurs qui exploitent un serveur dédié sous Proxmox VE et veulent déployer rapidement des services auto-hébergés. Nous installerons trois briques courantes : Docker dans un conteneur LXC, Nginx Proxy Manager pour le reverse proxy, et Uptime Kuma pour la supervision.

Prérequis

• Un serveur dédié ou un VPS Linux avec Proxmox VE 8.4 ou supérieur installé (la version actuelle est Proxmox VE 9.2, sortie en mai 2026) ;
• Un accès root au shell de l'hôte Proxmox (via SSH ou la console web) ;
• Une connexion Internet active sur l'hôte (les scripts téléchargent les paquets depuis les dépôts officiels) ;
• Au moins 4 Go de RAM et 40 Go de stockage disponibles pour les trois conteneurs LXC de ce guide.

Vérifier le code source avant exécution

Chaque script Community Scripts s'exécute en root sur votre hyperviseur Proxmox. Il est donc indispensable de vérifier le code source avant de lancer la commande. Ne faites jamais confiance aveuglément à un curl | bash exécuté en root, quel que soit le nombre d'étoiles du dépôt.

Avant d'exécuter un script, ouvrez son code source sur GitHub pour comprendre ce qu'il fait. Les scripts de création de conteneurs se trouvent dans le répertoire ct/ du dépôt. Par exemple, pour le script Docker :

# Lisez le script avant de l'exécuter
curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/docker.sh | less

Points à vérifier dans le code source :

• Les URL de téléchargement pointent bien vers des dépôts officiels (packages.debian.org, download.docker.com) ;
• Aucune commande n'envoie de données vers un serveur tiers ;
• Les ports ouverts correspondent au service installé, sans backdoor réseau ;
• Le script ne désactive pas de protections système (AppArmor, pare-feu) sans raison.

Community Scripts publie des releases taguées sur GitHub. Si vous préférez épingler une version, remplacez main par le tag de la release dans l'URL du script. Cela évite qu'une modification ultérieure du dépôt affecte votre installation.

Installer Docker dans un conteneur LXC

Docker est la base de la plupart des services auto-hébergés. Le script Community Scripts crée un conteneur LXC Debian avec Docker Engine et Docker Compose préinstallés. Depuis le shell de votre hôte Proxmox :

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/docker.sh)"

Le script propose deux modes :

• Default : applique des valeurs par défaut raisonnables pour le CPU, la RAM et le stockage. L'installation se termine en quelques minutes avec un minimum de questions ;
• Advanced : permet de choisir le template OS, le nombre de coeurs, la quantité de RAM, la taille du disque, le bridge réseau et l'adresse IP.

Une fois le conteneur créé, vérifiez que Docker fonctionne :

# Entrez dans le conteneur LXC (remplacez 100 par l'ID affiché)
pct enter 100

# Vérifiez la version Docker installée
docker --version
docker compose version

Ce conteneur LXC Docker peut ensuite héberger n'importe quelle application empaquetée en image Docker. Pour aller plus loin avec Docker Compose sur un serveur Linux, consultez notre guide Docker Compose sur VPS Linux.

Installer Nginx Proxy Manager

Nginx Proxy Manager (NPM) fournit une interface web pour gérer vos reverse proxies, vos certificats SSL Let's Encrypt et vos redirections HTTP. Il remplace la configuration manuelle des fichiers nginx.conf par un panneau de contrôle accessible depuis un navigateur.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/nginxproxymanager.sh)"

Après l'installation, accédez à l'interface web de Nginx Proxy Manager sur le port 81 du conteneur LXC (par exemple http://192.168.1.x:81). Les identifiants par défaut sont admin@example.com / changeme. Changez-les immédiatement après la première connexion.

Depuis l'interface, ajoutez un Proxy Host pour chaque service : indiquez le nom de domaine ou sous-domaine, l'adresse IP interne du conteneur LXC cible et son port. Activez le certificat SSL Let's Encrypt en un clic pour chiffrer le trafic HTTPS.

Installer Uptime Kuma

Uptime Kuma est un outil de monitoring open source qui surveille la disponibilité de vos services HTTP, TCP, DNS et ping. Il envoie des alertes par Webhook, Discord, Telegram ou email quand un service tombe. Indispensable quand vous hébergez plusieurs services sur un même serveur dédié.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/uptimekuma.sh)"

L'interface web est accessible sur le port 3001 du conteneur LXC (http://192.168.1.x:3001). Créez un compte administrateur lors de la première connexion, puis ajoutez vos moniteurs :

• HTTP(S) : vérifie qu'une URL répond avec un code 200 et mesure le temps de réponse ;
• TCP : teste la connectivité sur un port spécifique (utile pour un serveur de jeu ou une base de données) ;
• Ping : vérifie qu'une adresse IP ou un nom d'hôte répond aux requêtes ICMP ;
• DNS : contrôle qu'un enregistrement DNS renvoie la valeur attendue.

Configurez les notifications (Discord, Slack, email) pour être alerté en cas de panne. Uptime Kuma conserve l'historique de disponibilité et génère des pages de statut publiques que vous pouvez partager avec vos utilisateurs.

Sécuriser l'installation

Après avoir déployé vos conteneurs LXC, appliquez les bonnes pratiques de sécurité :

• Restreignez l'accès SSH à l'hôte Proxmox avec une authentification par clé publique (sécuriser SSH sur VPS Linux) ;
• Configurez le pare-feu Proxmox pour limiter les ports exposés. Seuls les ports nécessaires (80, 443 pour le reverse proxy, 8006 pour l'interface Proxmox) doivent être accessibles depuis Internet ;
• Placez tous vos services derrière Nginx Proxy Manager pour centraliser les certificats SSL et ne pas exposer les ports individuels de chaque conteneur LXC ;
• Mettez à jour régulièrement les conteneurs LXC et les services installés. Community Scripts fournit des helpers post-installation pour mettre à jour les services depuis le shell Proxmox ;
• Appliquez les premiers réglages de sécurité d'un serveur dédié à votre hôte Proxmox.

Aller plus loin

Les trois services installés dans ce guide ne sont qu'un point de départ. Le catalogue Community Scripts couvre des dizaines de catégories :

• Domotique : Home Assistant, Zigbee2MQTT, Node-RED ;
• Médias : Jellyfin, Plex, Radarr, Sonarr ;
• Bases de données : PostgreSQL, MariaDB, Redis, InfluxDB ;
• Sécurité : Vaultwarden, CrowdSec, Authentik ;
• Développement : Gitea, Portainer, n8n, VS Code Server ;
• Monitoring : Grafana, Prometheus, Netdata.

Pour chaque service, le principe reste le même : vérifiez le code source du script, lancez la commande depuis le shell Proxmox, puis configurez le service via son interface web. L'ensemble du catalogue est consultable sur community-scripts.org.

Si vous n'utilisez pas Proxmox et préférez installer Docker directement sur un VPS, les guides de la section serveurs dédiés et VPS Linux couvrent l'installation manuelle pas à pas.