Instalar Portainer con Docker Compose v2

Creamos un directorio de trabajo dedicado (~/docker/portainer) donde vivirá el compose.yaml del stack. Tener cada stack en su propia carpeta facilita versionarlo, respaldarlo y gestionarlo con `docker compose` desde ahí.

mkdir -p ~/docker/portainer

Escribimos compose.yaml siguiendo la Compose Specification actual: sin clave `version:`, imagen pineada a `portainer-ce:2.40.0` (nunca `:latest`), puertos 9443 (UI HTTPS) y 8000 (túnel del Edge Agent), el socket de Docker montado en solo lectura (`:ro`) porque Portainer lo gestiona todo por API, y un volumen nombrado `portainer_data` para que los datos sobrevivan a las actualizaciones.

cat > ~/docker/portainer/compose.yaml <<'YAML'
services:
  portainer:
    image: portainer/portainer-ce:2.40.0
    container_name: portainer
    restart: unless-stopped
    security_opt:
      - no-new-privileges:true
    ports:
      - "9443:9443"
      - "8000:8000"
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - portainer_data:/data
volumes:
  portainer_data:
YAML

Levantamos el stack en segundo plano (`-d`). Docker descarga la imagen si falta, crea el volumen `portainer_data` y arranca el contenedor `portainer` con la política `restart: unless-stopped`, que lo devuelve a la vida tras un reinicio del host.

cd ~/docker/portainer && docker compose up -d