Description:
When attempting to start a new pmm-client docker container, the following error is thrown during the setup steps: Failed to start Agent: mkdir /usr/local/percona/pmm/tmp/agent_type_vm_agent: permission denied.
Steps to Reproduce:
I followed the instructions located here - Install on Docker - Percona Monitoring and Management the part that fails is step 3
Version:
I’m using the latest image tag - percona/pmm-client:latest
Logs:
time=“2026-02-09T12:15:07.438+00:00” level=info msg=“Run setup: true Sidecar mode: false” component=entrypoint
time=“2026-02-09T12:15:07.438+00:00” level=info msg=“Starting ‘pmm-agent setup’…” component=entrypoint
time=“2026-02-09T12:15:07.471+00:00” level=info msg=“Loading configuration file /usr/local/percona/pmm/config/pmm-agent.yaml.” component=setup
Checking local pmm-agent status…
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Temporary directory will default to /usr/local/percona/pmm/tmp” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Nomad data directory will default to /usr/local/percona/pmm/data/nomad” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/tools/pt-mysql-summary as a path to Percona Toolkit pt-mysql-summary” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/tools/nomad as a path to Nomad binary” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/tools/pt-summary as a path to Percona Toolkit pt-summary” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/tools/pt-pg-summary as a path to Percona Toolkit pt-pg-summary” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/tools/pt-mongodb-summary as a path to Percona Toolkit pt-mongodb-summary” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/node_exporter as a path to node_exporter” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/mysqld_exporter as a path to mysqld_exporter” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/valkey_exporter as a path to valkey_exporter” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/rds_exporter as a path to rds_exporter” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/azure_exporter as a path to azure_exporter” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/vmagent as a path to vmagent” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/mongodb_exporter as a path to mongodb_exporter” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/postgres_exporter as a path to postgres_exporter” component=setup
time=“2026-02-09T12:15:07.472+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/proxysql_exporter as a path to proxysql_exporter” component=setup
pmm-agent is not running.
Registering pmm-agent on PMM Server…
Registered.
Configuration file /usr/local/percona/pmm/config/pmm-agent.yaml updated.
Please start pmm-agent: pmm-agent --config-file=/usr/local/percona/pmm/config/pmm-agent.yaml.
time=“2026-02-09T12:15:07.625+00:00” level=info msg=“‘pmm-agent setup’ exited with 0” component=entrypoint
time=“2026-02-09T12:15:07.625+00:00” level=info msg=“Starting ‘pmm-agent run’…” component=entrypoint
time=“2026-02-09T12:15:07.642+00:00” level=info msg=“Loading configuration file /usr/local/percona/pmm/config/pmm-agent.yaml.” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/rds_exporter as a path to rds_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/azure_exporter as a path to azure_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/vmagent as a path to vmagent” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/mysqld_exporter as a path to mysqld_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/mongodb_exporter as a path to mongodb_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/postgres_exporter as a path to postgres_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/node_exporter as a path to node_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/valkey_exporter as a path to valkey_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Using /usr/local/percona/pmm/exporters/proxysql_exporter as a path to proxysql_exporter” component=main
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Runner capacity set to 32, token capacity set to 2” component=runner
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Window check connection time is 1.00 hour(s)”
time=“2026-02-09T12:15:07.643+00:00” level=info msg=Starting… component=client
time=“2026-02-09T12:15:07.643+00:00” level=info msg=“Connecting to …” component=client
time=“2026-02-09T12:15:07.648+00:00” level=info msg=“Starting local API server on localhost :7777…” component=local-server/JSON
time=“2026-02-09T12:15:07.650+00:00” level=info msg=Started. component=local-server/JSON
time=“2026-02-09T12:15:07.655+00:00” level=info msg=“Connected to host.docker.internal:8443.” component=client
time=“2026-02-09T12:15:07.655+00:00” level=info msg=“Establishing two-way communication channel …” component=client
time=“2026-02-09T12:15:07.671+00:00” level=info msg=“Two-way communication channel established in 16.047516ms. Estimated clock drift: 5.906346ms.” component=client
time=“2026-02-09T12:15:08.743+00:00” level=info msg=“Starting 2, restarting 0, and stopping 0 agent processes.” component=supervisor
time=“2026-02-09T12:15:08.743+00:00” level=error msg=“Failed to start Agent: mkdir /usr/local/percona/pmm/tmp/agent_type_vm_agent: permission denied.” component=supervisor
time=“2026-02-09T12:15:08.744+00:00” level=error msg=“Failed to start Agent: mkdir /usr/local/percona/pmm/tmp/agent_type_node_exporter: permission denied.” component=supervisor