Skip to content

Commit b375a52

Browse files
committed
Add NFS permission troubleshooting for /data directory
Document the expected behavior when users cannot use chown/chgrp on /data due to NFS security restrictions. Include explanation that this is a feature, not a bug, and provide solution to perform these operations on roselab1 where the storage is physically hosted.
1 parent 4855f77 commit b375a52

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

docs/guide/troubleshooting.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,4 +136,42 @@ As of the latest server migration (October 2025), all NVIDIA drivers have been u
136136
nvidia-smi | grep "Driver Version"
137137
```
138138

139+
## File Permissions on `/data`
140+
141+
### Cannot Use chown/chgrp on `/data`
142+
143+
If you find that you cannot change file ownership or group on `/data` using `chown` or `chgrp` commands, even with `sudo`, this is expected behavior due to NFS security features.
144+
145+
```bash
146+
$ sudo chown username:groupname /data/some-folder
147+
# Operation not permitted or no effect
148+
```
149+
150+
#### Cause
151+
152+
The `/data` directory is a network-mounted filesystem (NFS) that is physically hosted on **roselab1** and mounted on all other servers (roselab2-5). NFS has security restrictions that prevent non-root users from changing file ownership, and LXC container root users are not considered "true" root users from the NFS perspective.
153+
154+
This is not a bug but a security feature of network-mounted filesystems to prevent unauthorized ownership changes across the network.
155+
156+
#### Solution
157+
158+
To change file permissions or ownership on `/data`:
159+
160+
1. **SSH into your container on roselab1** (where `/data` is physically hosted):
161+
```bash
162+
ssh [email protected] -p your-port
163+
```
164+
165+
2. **Run chown/chgrp commands there**:
166+
```bash
167+
sudo chown username:groupname /data/your-folder
168+
sudo chmod 755 /data/your-folder
169+
```
170+
171+
3. The changes will be immediately visible across all servers since `/data` is synchronized.
172+
173+
::: tip
174+
If you need to perform bulk permission changes, it's most efficient to do them from roselab1 where the storage is physically located.
175+
:::
176+
139177

0 commit comments

Comments
 (0)