Notes

Si votre VM Proxmox héberge Docker, installez l’agent Portainer dans cette VM. Proxmox n’a pas besoin d’une configuration particulière : l’agent communique avec le Portainer Server via le réseau.

1. Préparer la VM

Dans la VM Linux :

docker --version
docker ps

Si Docker n’est pas installé, installez-le d’abord. Vérifiez également que la VM possède une adresse IP joignable depuis le serveur Portainer.

2. Déployer l’agent Portainer

Sur la VM Docker, exécutez :

docker run -d \
  --name portainer_agent \
  --restart=always \
  -p 9001:9001 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  portainer/agent:lts

Le volume /var/run/docker.sock permet à l’agent de communiquer avec Docker. Le montage des volumes Docker permet notamment à Portainer d’accéder aux volumes de l’environnement.

Vérifiez que le conteneur fonctionne :

docker ps
docker logs portainer_agent

3. Autoriser le port 9001

Le serveur Portainer doit pouvoir joindre la VM sur le port TCP 9001.

Avec UFW :

sudo ufw allow from IP_DU_SERVEUR_PORTAINER to any port 9001 proto tcp
sudo ufw reload

Évitez d’exposer le port 9001 à Internet. Autorisez uniquement l’adresse IP du serveur Portainer, ou utilisez un réseau privé/VLAN entre les deux machines. L’agent standard nécessite que le port 9001 soit accessible depuis le serveur Portainer.

Depuis le serveur Portainer, testez :

nc -vz IP_DE_LA_VM 9001

Vous devez obtenir une connexion réussie.

4. Ajouter la VM dans Portainer

Dans l’interface Portainer :

1. Ouvrez Environments.
2. Cliquez sur Add environment.
3. Sélectionnez Docker Standalone.
4. Cliquez sur Start Wizard.
5. Choisissez l’option Agent.
6. Donnez un nom, par exemple VM-Docker-Proxmox.
7. Dans Environment URL, indiquez :

IP_DE_LA_VM:9001

Exemple :

192.168.10.25:9001

Ne mettez pas http:// ou https:// dans ce champ : Portainer utilise la communication sécurisée de l’agent.

1. Cliquez sur Connect.

Cas où Portainer Server est aussi dans cette VM

Si le serveur Portainer et l’agent sont installés sur la même VM Docker, vous pouvez utiliser une installation complète :

docker volume create portainer_data

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

L’interface sera alors accessible sur :

https://IP_DE_LA_VM:9443

Portainer utilise par défaut le port 9443 pour l’interface et le port 8000 pour certaines fonctions Edge.

Architecture recommandée

[Serveur Portainer]
        |
        | TCP 9001
        v
[VM Linux sur Proxmox]
        |
        v
[Docker + Portainer Agent]

Si vous ne pouvez pas ouvrir le port 9001 vers la VM, utilisez plutôt l’Edge Agent : il initie lui-même la connexion vers le serveur Portainer et est recommandé par Portainer pour les environnements distants ou difficiles à joindre.

---

Sur une VM Alpine Linux hébergée dans Proxmox, il faut installer Docker, puis lancer le conteneur Portainer Agent.

1. Installer et démarrer Docker sur Alpine

Connectez-vous à la VM en root :

apk update
apk add docker docker-cli-compose

Activez Docker au démarrage et lancez-le :

rc-update add docker default
service docker start

Vérifiez son fonctionnement :

docker version
docker ps

Si vous utilisez un compte non-root, ajoutez-le au groupe Docker :

addgroup utilisateur docker

Puis reconnectez-vous à la session.

2. Déployer Portainer Agent

Lancez l’agent avec l’image LTS :

docker volume create portainer_agent_data

docker run -d \
  --name portainer_agent \
  --restart=always \
  -p 9001:9001 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  portainer/agent:lts

Portainer utilise le socket Docker Unix et le port TCP 9001 pour l’agent standard. Le montage de /var/lib/docker/volumes est nécessaire pour permettre la gestion des volumes Docker depuis Portainer.

Contrôlez le conteneur :

docker ps
docker logs portainer_agent

Vous devriez voir un conteneur portainer/agent:lts en état Up.

3. Ouvrir le port 9001

Si un pare-feu est actif dans la VM, autorisez uniquement l’adresse IP du serveur Portainer.

Avec iptables :

iptables -A INPUT -p tcp -s IP_SERVEUR_PORTAINER --dport 9001 -j ACCEPT

Remplacez :

IP_SERVEUR_PORTAINER

par l’adresse réelle du serveur Portainer.

Depuis le serveur Portainer, testez la connexion :

nc -vz IP_DE_LA_VM_ALPINE 9001

Exemple :

nc -vz 192.168.1.50 9001

4. Ajouter l’environnement dans Portainer

Dans Portainer Server :

1. Allez dans Environments.
2. Cliquez sur Add environment.
3. Sélectionnez Docker Standalone.
4. Choisissez Agent.
5. Saisissez l’URL suivante :

IP_DE_LA_VM_ALPINE:9001

Exemple :

192.168.1.50:9001

1. Donnez un nom à l’environnement.
2. Cliquez sur Connect.

N’utilisez pas http:// devant l’adresse.

5. Vérifications utiles

Vérifier que Docker écoute :

ss -lntp | grep 9001

Vérifier l’adresse IP de la VM :

ip addr

Vérifier le démarrage automatique :

rc-status

Pour mettre à jour l’agent :

docker pull portainer/agent:lts
docker stop portainer_agent
docker rm portainer_agent

Puis relancez la commande docker run précédente. Il est préférable de mettre à jour le serveur Portainer avant ses agents.

Points importants avec Alpine

• La VM doit utiliser une architecture compatible avec l’image Docker, généralement amd64.
• Le service Docker doit être démarré avant le lancement de l’agent.
• Le port 9001 doit être accessible depuis Portainer Server.
• Si le serveur Portainer ne peut pas joindre la VM, utilisez plutôt un Edge Agent, qui fonctionne avec une connexion initiée depuis la VM.
• Si Docker fonctionne en mode rootless, le montage de /var/run/docker.sock et les permissions peuvent nécessiter une configuration différente.