Homelab/optimized/standalone/Portainer_Agent_Standalone/README.md

Portainer Agent (Standalone Host)

This directory contains the docker-compose.yml for deploying a Portainer Agent on a standalone Docker (or Podman) host. This agent allows a central Portainer instance (potentially running in a Swarm) to manage this individual host.

Running with Podman Compose

To deploy the Portainer Agent using podman-compose:

1. Navigate to this directory:

   cd optimized/standalone/Portainer_Agent_Standalone
   

2. Important: Replace 192.168.1.81 with the actual IP address or resolvable hostname of your Portainer Server instance in the docker-compose.yml.
3. Start the agent:

   podman-compose up -d
   

Running with Podman

You can run the Portainer Agent directly with Podman:

podman run -d \
  --name portainer-agent \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  -e AGENT_CLUSTER_ADDR=192.168.1.81 \
  -e AGENT_PORT=9001 \
  -p "9001:9001" \
  portainer/agent:latest

Notes

• This agent is specifically for managing a standalone Docker/Podman host. If you intend to manage a Swarm cluster, the Portainer Swarm stack (found in optimized/swarm/Portainer) should be used, which typically deploys agents globally across the Swarm nodes.
• The volumes /var/run/docker.sock and /var/lib/docker/volumes are critical for the agent to communicate with and manage the Docker/Podman daemon.
• Ensure AGENT_CLUSTER_ADDR points to your actual Portainer Server.