Upgrade PMM Server using Podman¶

Before you begin¶

Before starting the upgrade, complete these preparation steps to ensure you can recover your system if needed and confirm compatibility with the new version:

Create a backup before upgrading, as downgrades are not possible. Therefore, reverting to a previous version requires an backup made prior to the upgrade.
Verify your current PMM version: Check your current PMM version by navigating to PMM Configuration > Updates or by running the following command:
```
podman exec -it pmm-server \
curl -ku admin:admin https://localhost/v1/version
```

Upgrade steps¶

Follow these steps to upgrade your PMM Server while preserving your monitoring data and settings—you can restore from your backup if needed.

Back up your data.
Update PMM tag by editing ~/.config/systemd/user/pmm-server.env file and running the following command to set the latest release version:
```
sed -i "s/PMM_IMAGE=.*/PMM_IMAGE=docker.io/percona/pmm-server:3.0.0/g" ~/.config/systemd/user/pmm-server.env
```

Pre-pull the new image to ensure a faster restart:

source ~/.config/systemd/user/pmm-server.env
podman pull ${PMM_IMAGE}:${PMM_TAG}

Restart PMM Server:
```
systemctl --user restart pmm-server
```
After the upgrade, verify that PMM Server is running correctly:
```
podman ps | grep pmm-server
```
Check the logs for any errors:
```
podman logs pmm-server
```

Get expert help¶

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert