Guide complet : Déployer Portainer comme premier conteneur Docker sur votre NAS

Si vous envisagez de construire un NAS ou venez d’en acquérir un, la compatibilité Docker devrait figurer en tête de vos priorités. Une fois cette fonctionnalité confirmée, il existe un conteneur Docker que tout administrateur système expérimenté déploie systématiquement en premier : Portainer. Ce guide vous expliquera pourquoi ce choix est stratégique et comment procéder étape par étape.

Matériel et prérequis nécessaires

Avant de commencer l’installation de Portainer, assurez-vous de disposer des éléments suivants :

• Un NAS compatible Docker (Synology, QNAP, TrueNAS, Unraid, ou serveur Linux personnalisé)
• Accès administrateur au système d’exploitation du NAS
• Connexion SSH activée ou accès au terminal système
• Docker installé et fonctionnel sur votre NAS
• Au moins 2 Go de RAM disponible pour un fonctionnement optimal
• Connexion Internet stable pour télécharger l’image Docker
• Navigateur web moderne pour accéder à l’interface Portainer

Étape 1 : Comprendre pourquoi Portainer est essentiel

Portainer transforme radicalement l’expérience Docker en offrant une interface graphique intuitive là où la ligne de commande peut sembler intimidante. Imaginez Docker CLI comme un cockpit d’avion avec des centaines de boutons techniques, tandis que Portainer ressemble au tableau de bord simplifié d’une voiture moderne.

Les avantages décisifs de Portainer

Cette solution présente plusieurs atouts majeurs qui justifient son déploiement prioritaire :

• Interface unifiée : Même expérience utilisateur sur tous les systèmes compatibles Docker
• Gestion simplifiée : Déploiement, surveillance et maintenance des conteneurs via interface web
• Support Docker Compose : Import et gestion des fichiers de composition complexes
• Surveillance en temps réel : Monitoring des ressources et logs centralisés

Étape 2 : Préparer l’environnement Docker

Connectez-vous à votre NAS via SSH ou ouvrez un terminal système. Vérifiez d’abord que Docker fonctionne correctement :

Commande de vérification :

docker --version

Cette commande doit retourner la version installée de Docker. Si une erreur apparaît, installez Docker selon la documentation de votre système d’exploitation.

Vérification des ports disponibles

Portainer utilise les ports 8000 et 9443. Vérifiez leur disponibilité :

netstat -tuln | grep -E ':(8000|9443)'

Attention : Si ces ports sont occupés, vous devrez modifier les paramètres de déploiement ou libérer ces ports.

Étape 3 : Créer le volume de données Portainer

La première commande crée un volume Docker persistant pour stocker les données de configuration de Portainer :

docker volume create portainer_data

Cette étape est cruciale car elle garantit que vos configurations Portainer survivront aux redémarrages et mises à jour du conteneur. Le volume agit comme un coffre-fort numérique pour toutes vos données importantes.

Vérification de la création du volume

Confirmez la création du volume avec :

docker volume ls

Vous devriez voir “portainer_data” dans la liste des volumes disponibles.

Étape 4 : Déployer le conteneur Portainer

Exécutez maintenant la commande de déploiement principale :

docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts

Décryptage des paramètres de déploiement

Chaque élément de cette commande a un rôle spécifique :

• -d : Exécution en arrière-plan (mode détaché)
• -p 8000:8000 -p 9443:9443 : Mappage des ports pour l’accès web
• –name portainer : Attribution d’un nom explicite au conteneur
• –restart=always : Redémarrage automatique en cas d’arrêt
• -v /var/run/docker.sock:/var/run/docker.sock : Accès au socket Docker pour la gestion
• -v portainer_data:/data : Montage du volume de données
• portainer/portainer-ce:lts : Image officielle version LTS (Long Term Support)

Étape 5 : Vérifier le déploiement

Confirmez que Portainer fonctionne correctement :

docker ps

Cette commande affiche tous les conteneurs en cours d’exécution. Portainer doit apparaître avec le statut “Up”.

Vérification des logs

En cas de problème, consultez les logs du conteneur :

docker logs portainer

Attention : Si des erreurs apparaissent, vérifiez les permissions et la disponibilité des ports.

Étape 6 : Configuration initiale de Portainer

Ouvrez votre navigateur web et accédez à l’interface Portainer via l’une de ces URL :

• HTTPS (recommandé) : https://[IP_DE_VOTRE_NAS]:9443
• HTTP : http://[IP_DE_VOTRE_NAS]:8000

Création du compte administrateur

Lors du premier accès, Portainer vous demande de créer un compte administrateur :

1. Saisissez un nom d’utilisateur (recommandation : évitez “admin” pour la sécurité)
2. Définissez un mot de passe robuste (minimum 12 caractères avec majuscules, minuscules, chiffres et symboles)
3. Confirmez le mot de passe
4. Cliquez sur “Create user”

Important : Cette étape doit être réalisée dans les 5 minutes suivant le démarrage de Portainer, sinon le conteneur se verrouillera pour des raisons de sécurité.

Étape 7 : Connecter Portainer à Docker

Après la création du compte, Portainer vous demande de configurer l’environnement Docker :

1. Sélectionnez “Docker” comme type d’environnement
2. Choisissez “Local” pour une installation sur le même système
3. Cliquez sur “Connect”

Portainer détecte automatiquement l’installation Docker locale grâce au socket monté lors du déploiement.

Étape 8 : Explorer l’interface Portainer

Une fois connecté, familiarisez-vous avec les sections principales :

Dashboard principal

Le tableau de bord affiche :

• Nombre de conteneurs actifs et arrêtés
• Images Docker disponibles localement
• Volumes créés et leur utilisation
• Réseaux Docker configurés

Gestion des conteneurs

La section “Containers” permet de :

• Visualiser tous les conteneurs avec leur statut
• Démarrer, arrêter ou redémarrer des conteneurs
• Accéder aux logs en temps réel
• Ouvrir une console dans le conteneur

Étape 9 : Déployer votre premier conteneur via Portainer

Pour tester Portainer, déployons un conteneur simple comme Nginx :

1. Cliquez sur “Containers” dans le menu latéral
2. Sélectionnez “Add container”
3. Nommez le conteneur : “test-nginx”
4. Image Docker : nginx:latest
5. Port mapping : 8080:80 (port local : port conteneur)
6. Cliquez sur “Deploy the container”

Cette démonstration illustre la simplicité de déploiement via Portainer comparé aux commandes CLI traditionnelles.

Étape 10 : Configuration avancée et sécurisation

Activation du HTTPS

Pour sécuriser l’accès à Portainer, configurez un certificat SSL :

1. Accédez à “Settings” dans Portainer
2. Section “SSL certificate”
3. Uploadez votre certificat et clé privée
4. Redémarrez Portainer pour appliquer les changements

Gestion des utilisateurs

Créez des comptes utilisateurs avec permissions limitées :

1. Menu “Users”
2. “Add user”
3. Définissez les rôles : Administrator, Operator, ou Helpdesk
4. Assignez des équipes si nécessaire

Étape 11 : Sauvegarde et maintenance

Sauvegarde des données Portainer

Créez une sauvegarde régulière du volume de données :

docker run --rm -v portainer_data:/data -v $(pwd):/backup alpine tar czf /backup/portainer_backup_$(date +%Y%m%d).tar.gz -C /data .

Mise à jour de Portainer

Pour mettre à jour Portainer vers la dernière version :

1. Arrêtez le conteneur actuel : docker stop portainer
2. Supprimez le conteneur : docker rm portainer
3. Téléchargez la nouvelle image : docker pull portainer/portainer-ce:lts
4. Redéployez avec la même commande de l’étape 4

Dépannage des problèmes courants

Portainer ne démarre pas

Solutions à vérifier :

• Ports occupés : Modifiez les ports dans la commande de déploiement
• Permissions insuffisantes : Exécutez Docker avec sudo si nécessaire
• Socket Docker inaccessible : Vérifiez les permissions sur /var/run/docker.sock

Interface inaccessible

Points de contrôle :

• Pare-feu : Autorisez les ports 8000 et 9443
• Adresse IP : Utilisez l’IP correcte du NAS
• Protocole : Testez HTTP et HTTPS

Conclusion

Portainer représente la fondation idéale pour tout environnement Docker sur NAS. Son déploiement en première position simplifie considérablement la gestion ultérieure des conteneurs et offre une expérience utilisateur cohérente quel que soit le système d’exploitation sous-jacent.

Cette approche méthodique garantit non seulement un déploiement réussi, mais établit également les bases d’une infrastructure Docker robuste et facilement maintenable. Une fois Portainer opérationnel, vous découvrirez qu’installer et gérer d’autres conteneurs comme Plex, Pi-hole, ou Home Assistant devient un jeu d’enfant.

L’investissement en temps pour cette installation initiale se rentabilise rapidement grâce aux gains de productivité et à la réduction de la complexité administrative. Portainer transforme Docker d’un outil technique en une plateforme accessible, même aux utilisateurs moins expérimentés en ligne de commande.

Sandrine Marcos

Rédactrice spécialisée en édition de site. Formation de journaliste et passionnée par les nouvelles technologies, l’intelligence artificielle et la rédaction web.