Why have my agents stopped working after upgrading Portainer?

If you have recently updated Portainer and have found your Agents or Edge Agents are no longer communicating, you may need to check to confirm whether you have set a custom AGENT_SECRET value. If this has been defined on the Portainer Server it will need to be set on the agents as well. This applies to both the standard Portainer Agent and the Portainer Edge Agent.
For information on how to define the AGENT_SECRET on each platform, please refer to the respective upgrade instructions:
Docker Standalone
In your docker run command for your Agent or Edge Agent, set the AGENT_SECRET environment variable to the value set on your Portainer Server instance:
1
-e AGENT_SECRET=yoursecret
Copied!
For example, your Agent docker run command may look like this:
1
docker run -d -p 9001:9001 --name portainer_agent --restart=always \
2
    -v /var/run/docker.sock:/var/run/docker.sock \
3
    -v /var/lib/docker/volumes:/var/lib/docker/volumes \
4
    -e AGENT_SECRET=yoursecret
5
    portainer/agent:2.9.3
Copied!
Docker Swarm
In your stack file for your Docker Swarm Agent or Edge Agent deployment, set the AGENT_SECRET environment variable to the value set on your Portainer Server instance:
1
environment:
2
  - AGENT_SECRET: yoursecret
Copied!
​
Kubernetes
In your YAML file for your Kubernetes Agent or Edge Agent deployment, set the AGENT_SECRET environment variable to the value set on your Portainer Server instance within the agent deployment definition:
1
env:
2
  - name: AGENT_SECRET
3
    value: yoursecret
Copied!

Why does Portainer keep prompting me to upgrade?

Can I upgrade an environment from Docker Standalone to Docker Swarm?

Last modified 3mo ago

Copy link

Edit on GitHub

Contents

Docker Standalone

Docker Swarm

Kubernetes