Skip to content

Commit 11ca185

Browse files
authored
[DOCS] Rel Notes about ports change (#3768)
* [DOCS] Rel Notes about ports change * improved wording
1 parent 14a43f7 commit 11ca185

File tree

1 file changed

+26
-0
lines changed
  • documentation/docs/release-notes

1 file changed

+26
-0
lines changed

documentation/docs/release-notes/3.0.0.md

+26
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,32 @@ This rootless setup enhances security by eliminating the need for root privilege
4343

4444
For instructions on deploying rootless PMM, check the [Setting up PMM Server](../install-pmm/install-pmm-server/index.md) topic.
4545

46+
### Internal port changes
47+
As part of the rootless deployment support, PMM 3 changes the internal ports used by the PMM Server to enabling services to run without elevated (root) privileges:
48+
49+
| Service | Old port | New port |
50+
|---------|----------|----------|
51+
| HTTPS | 443 | 8443 |
52+
| HTTP | 80 | 8080 |
53+
54+
#### Impact and required actions
55+
56+
- if you have custom scripts that reference the old internal ports (`443` and `80`), update them to use the new ports (`8443` and `8080`)
57+
58+
- for Docker or Docker Compose deployments, update your port mappings to point to the new internal ports while keeping your external ports the same if desired:
59+
60+
??? info "Docker Compose example"
61+
62+
```yaml
63+
services:
64+
pmm-server:
65+
ports:
66+
- "443:8443" # Map external 443 to internal 8443
67+
- "80:8080" # Map external 80 to internal 8080
68+
```
69+
70+
For examples of configuring PMM 3 with Docker Compose, including port mappings, see [Docker deployment documentation](../install-pmm/install-pmm-server/deployment-options/docker/run_with_vol.md) and this [Percona Forum thread](https://forums.percona.com/t/install-pmm-3-using-docker-compose-and-connect-mysql-postgres-mongodb/36457).
71+
4672
### UI-based upgrades for Podman installations
4773

4874
You can now upgrade PMM Server installations running under Podman directly through the **PMM Configuration > Updates** panel in the UI.

0 commit comments

Comments
 (0)