Skip to content

Portainer

Portainer logo

Overview

Field Value
Purpose Provide a Docker administration UI
Business function Support container inspection and controlled changes
Owner IT Operations
Criticality Medium
Image portainer/portainer-ce:2.21.4-alpine
Route mgmt.kh3group.com

Architecture

Portainer connects to the local Docker socket and is published through Traefik.

Installation

Docker Compose at /root/portainer/docker-compose.yml.

Configuration

  • Data: /root/portainer/data:/data
  • Docker socket: /var/run/docker.sock
  • Network: aproxy
  • Restart policy: unless-stopped

Operational Procedures

cd /root/portainer
docker compose logs --tail=100 portainer
docker compose restart portainer
docker compose pull
docker compose up -d

Back up /root/portainer/data before upgrades. Use Compose as the deployment source rather than making undocumented stack changes only in the UI.

Troubleshooting

  • Endpoint unavailable: check Docker socket mount and permissions.
  • Login failure: follow the approved credential recovery process.
  • UI change drift: reconcile the resulting runtime with Compose.