services:
  portainer_agent:
    # The official Portainer Agent image
    image: portainer/agent:2.33.2
    
    # The container will be named 'portainer_agent'
    container_name: portainer_agent
    
    # Always restart the container if it stops
    restart: always
    
    environment:
      - AGENT_SECRET=${AGENT_SECRET}

    ports:
      # Exposes the agent's communication port to the host
      - "9001:9001"
      
    volumes:
      # Grants access to the Docker socket
      - /var/run/docker.sock:/var/run/docker.sock
      # Allows management of Docker volumes
      - /var/lib/docker/volumes:/var/lib/docker/volumes
      # Allows browsing the host filesystem (optional but useful)
      - /:/host