Skip to content

Commit 3bfa7f7

Browse files
committed
chore: upgrade guidance for non-root container change
1 parent bb195f3 commit 3bfa7f7

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

  • content/influxdb3/explorer/release-notes

content/influxdb3/explorer/release-notes/_index.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,19 @@ docker pull influxdata/influxdb3-ui
1818

1919
## v1.7.0 {date="2026-04-14"}
2020

21+
#### Breaking changes
22+
23+
- **Container user change**: The Docker container now runs as non-root user `influxui` (uid 1500) instead of root for improved security.
24+
25+
**Action required for upgrades:** If you're upgrading from v1.6.x or earlier with mounted volumes (e.g., `/db`, `/app-root/config`), you must update file ownership before the container will start:
26+
27+
```bash
28+
sudo chown -R 1500:1500 /path/to/your/db
29+
sudo chown -R 1500:1500 /path/to/your/config
30+
```
31+
32+
The container will exit with a clear error message and instructions if it detects root-owned files. Fresh installations are unaffected.
33+
2134
#### Features
2235

2336
- **Transform Data**: Rename tables (measurements), rename columns, transform values (such as unit conversions), and filter rows from a dedicated Transform Data page with dry-run testing.
@@ -28,6 +41,7 @@ docker pull influxdata/influxdb3-ui
2841
- **Line protocol validation**: Get clearer, inline validation when writing data with line protocol.
2942
- **TLS certificate management**: Generate and renew short-lived TLS certificates for IP-based deployments.
3043
- **Storage type display**: View the configured storage type for your InfluxDB instance in the metrics UI.
44+
- **Security**: Container now runs as non-root user (uid 1500) for improved security posture.
3145

3246
#### Bug fixes
3347

0 commit comments

Comments
 (0)