Comment installer Portainer : L’interface graphique indispensable pour Docker

TTZil y a 2 semaines

0 196 4 minutes de lecture

On vient d’installer Docker en ligne de commande dans le précédent tutoriel et c’est une excellente première étape. C’est puissant et robuste pour administrer notre système.

Mais soyons honnêtes : au quotidien, taper docker ps -a dix fois par jour pour vérifier les conteneurs, fouiller dans les logs, etc, c’est vite fastidieux.

Pourquoi Portainer ?

Portainer est un tableau de bord Web qui se connecte au moteur Docker pour offrir une vue d’ensemble claire et visuelle de tout notre environnement.

Concrètement, au lieu de taper des commandes, on pourra par exemple :

Déployer facilement de nouvelles applications
Visualiser d’un seul coup d’œil tous les conteneurs actifs, arrêtés, et leur consommation de ressources (CPU / RAM)
Redémarrer, arrêter ou supprimer un service en 1 seul clic

Dans ce tutoriel, nous allons installer la version gratuite et complète : Portainer CE (Community Edition). Et la bonne nouvelle, c’est que Portainer s’installe comme un conteneur Docker !

Préparation de l’environnement sur le serveur

Une installation pérenne commence par une bonne organisation.

Une bonne pratique consiste à centraliser tous les projets directement dans le répertoire personnel de l’utilisateur dédié ( /home/docker ) créé précédemment. Et un sous-dossier par service, ce qui donnera : Portainer dans /home/docker/portainer, AutreService dans /home/docker/autreservice, etc.

Cette méthode garantit un système parfaitement rangé et rend les sauvegardes futures extrêmement simples : il suffira de copier ce dossier parent pour tout sauvegarder.

Commençons par créer l’espace pour Portainer (un dossier portainer + un autre dossier data pour la persistance des données) :

# 1. Créer l'arborescence complète pour Portainer (configuration et données)
# Pas besoin de 'sudo' car nous sommes dans le dossier personnel de notre utilisateur 'docker'.
mkdir -p /home/docker/portainer/data

# 2. Se placer dans le dossier principal du projet pour la suite du tuto
cd /home/docker/portainer

Création du fichier Docker Compose

On crée le fichier de configuration :

nano docker-compose.yml

avec le contenu suivant :

services:
  portainer:
    container_name: portainer
    # On reste sur la version LTS Stable (plutôt que latest) 
    image: portainer/portainer-ce:lts
    # Politique de redémarrage : 'always' ou 'unless-stopped' recommandés
    restart: unless-stopped
    
    volumes:
      # Donne à Portainer le droit de piloter notre Docker
      # Doit être en lecture/écriture (rw, par défaut) pour pouvoir créer/supprimer conteneurs
      - /var/run/docker.sock:/var/run/docker.sock
      # On utilise notre dossier local 'data' créé juste avant (chemin relatif)
      - ./data:/data

    ports:
      # Port HTTPS standard pour accéder à l'interface
      - 9443:9443

# Section optionnelle mais considérée comme une bonne pratique
# Elle donne un nom fixe à ce réseau au lieu d'un nom auto-généré
networks:
  default:
    name: portainer_network

Le format YAML est extrêmement sensible à l’indentation (espaces en début de ligne). C’est ce qui définit toute la structure du fichier. Un décalage d’un seul espace peut empêcher le démarrage de Portainer.

Règle d’or : N’utilisez jamais la touche ‘Tabulation’ de votre clavier pour aligner le texte. Utilisez uniquement la barre d’espace. Si vous avez copié-collé le bloc ci-dessus, assurez-vous que l’alignement a été conservé.

Déploiement du conteneur

Tout est prêt : nous sommes dans le bon dossier et notre fichier de configuration est enregistré. Il ne reste plus qu’à demander à Docker d’exécuter le plan :

docker compose up -d

Docker va alors télécharger l’image nécessaire, créer le réseau, lier le volume de données et démarrer le conteneur.

Une fois fait, vous pouvez vérifier que le conteneur tourne bien :

docker ps

Vous devriez voir une ligne indiquant que le conteneur portainer est en statut Up (depuis quelques secondes) et qu’il écoute sur le port 0.0.0.0:9443->9443/tcp.

Première connexion et Configuration initiale

Le conteneur tourne, il est temps d’accéder à l’interface Web pour finaliser l’installation.

Ouvrez votre navigateur et tapez l’adresse suivante : https://<IP_DE_VOTRE_SERVEUR>:9443

HTTPS : très important
Remplacez <IP_DE_VOTRE_SERVEUR> par l’IP de votre serveur
Et n’oubliez pas les 2 points suivi du numéro du port :9443 (celui défini dans le fichier de configuration)
Ce qui, au final, devrait donner quelque chose comme https://192.168.1.50:9443

Votre navigateur va afficher une page d’alerte rouge « Votre connexion n’est pas privée ». C’est normal ! Portainer utilise un certificat auto-signé pour chiffrer la connexion mais le navigateur ne connait pas l’émetteur. Vous pouvez contourner l’avertissement en cliquant sur « Paramètres avancés » puis « Continuez sur le site » (la procédure peut être légèrement différente suivant le navigateur).

Capture Écran de l'alerte du navigateur indiquant "Votre connexion n'est pas privée" lors de l'accès HTTPS à l'interface de Portainer. — Alerte « normale » car Portainer utilise un certificat auto-signé par défaut

Vous arriverez sur l’écran de création du compte administrateur principal :

Nom par défaut admin mais vous pouvez le changer pour plus de sécurité
Choisissez un mot de passe fort
Laissez coché (ou décochez) la case pour envoyer des statistiques anonymes

Capture Écran de l'interface initiale de Portainer montrant le formulaire de création du compte administrateur. — Définissez un nom et un mot de passe fort pour sécuriser votre accès administrateur

On arrive désormais sur l’interface de Portainer, le choix par défaut Get Started est le bon pour gérer le Docker lequel nous sommes. Cliquez simplement sur ce bouton…

Capture Écran page de bienvenue de Portainer proposant de commencer avec l'environnement local "Get Started" ou d'en ajouter d'autres. — Cliquez sur le bouton « Get Started » pour gérer le Docker local.

Félicitations ! Vous êtes sur le tableau de bord. Vous pouvez voir votre environnement local listé. Cliquez dessus pour voir le résumé de l’état de votre serveur : nombre de Stacks, de Conteneurs, d’Images, de Volumes…

Capture Écran du tableau de bord d'accueil "Home" de Portainer affichant le résumé de l'environnement Docker local. — Tableau de bord d’accueil confirme que Portainer est connecté avec succès à votre environnement Docker local.

Capture Écran Tableau de Bord principal de l'environnement local dans Portainer. — Tableau de bord d’accueil confirme que Portainer est connecté avec succès à votre environnement Docker local.

Nous aurons l’occasion de revenir sur l’interface graphique de Portainer pour déployer nos futurs conteneurs lors de prochains tutoriels…

L’essentiel

Voici le résumé des points clés de ce tutoriel pour une installation propre et durable :

Méthode : Privilégier l’installation via Docker Compose plutôt qu’une simple commande ‘docker run’. Cela garantit une configuration reproductible et facile à mettre à jour.
Organisation : Adoptez une structure rigoureuse, un dossier dédié par service dans le répertoire personnel de votre utilisateur Docker (ex: /home/docker/portainer/). Cela simplifie grandement les sauvegardes futures.
Image Docker : Préférez le tag :lts (Long Term Support) au tag :latest pour une meilleure stabilité en production.
Persistance : N’oubliez pas le volume de données (./data:/data) et soyez attentif au chemin !
Sécurité : L’alerte HTTPS du navigateur lors de la première connexion est normale (certificat auto-signé). Pensez à définir un mot de passe fort pour le compte administrateur.