Skip to content

Commit 675b7ab

Browse files
committed
Add nonroot notes about security opts
1 parent 204eb1f commit 675b7ab

1 file changed

Lines changed: 30 additions & 1 deletion

File tree

docs/misc/non-root.md

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,8 @@ Our images use s6 as a supervisor and that needs to be able to write its service
3535
* Docker Mods will not be run
3636
* Custom Services will not be run
3737
* Custom Scripts will be limited in their functionality
38-
* You cannot set `no-new-privileges=true` as it will prevent s6 from being able to start the init process
38+
* You cannot set `no-new-privileges=true` unless you additionally set permissions on /run to match your `user` UID and GID
39+
* This is because s6 needs `/run` to be owned by the user running the container
3940

4041
For all of these reasons, we recommend you *do not* switch existing container instances to run with a non-root user without careful testing.
4142

@@ -58,6 +59,34 @@ services:
5859
user: 1000:1000
5960
```
6061

62+
or
63+
64+
```yaml
65+
services:
66+
sonarr:
67+
image: lscr.io/linuxserver/radarr:latest
68+
container_name: radarr
69+
environment:
70+
- TZ=Europe/London
71+
volumes:
72+
- /path/to/radarr/data:/config
73+
- /path/to/movies:/movies
74+
- /path/to/downloadclient-downloads:/downloads
75+
ports:
76+
- 7878:7878
77+
restart: unless-stopped
78+
user: 1000:1000
79+
tmpfs:
80+
- /run:uid=1000,gid=1000,exec
81+
security_opt:
82+
- no-new-privileges=true
83+
```
84+
6185
## Support Policy
6286

6387
Operation of our images with a non-root user is supported on a Reasonable Endeavours basis and *only* for images which we have specifically tested. These images will have their ability to be run with a non-root user noted in the readme, along with any additional caveats. Please see our [Support Policy](https://linuxserver.io/supportpolicy) for more details.
88+
89+
## Change History
90+
91+
* 2025-08-13 - Add notes about `no-new-privileges=true`
92+
* 2024-12-17 - Initial release

0 commit comments

Comments
 (0)