# PMM (Percona Monitoring and Management)

PMM provides database monitoring and management dashboards.

Host vars (per app):
```yaml
apps:
  - name: pmm                 # required
    type: pmm                 # required
    domain: "pmm.example.com" # required
    user: deploy              # optional, defaults to first in users
    pmm_image: "percona/pmm-server:3"  # optional
    pmm_data_dir: "/var/lib/pmm-pmm"   # optional
    pmm_container_name: "pmm-pmm"      # optional
    pmm_https_port: 9443               # optional
    acme_root: /var/www/letsencrypt    # optional
    cert: letsencrypt                  # optional
    letsencrypt_email: admin@example.com  # required if cert=letsencrypt
```

Defaults:
- `user`: first entry in `users`
- `pmm_image`: percona/pmm-server:3
- `pmm_data_dir`: /var/lib/pmm-<app.name>
- `pmm_container_name`: pmm-<app.name>
- `pmm_https_port`: 9443
- `acme_root`: /var/www/letsencrypt
- `cert`: unset

Notes:
- The PMM admin password is generated on first run and stored in `/etc/ploy/password.json`.