Skip to content

Commit df0ae8f

Browse files
committed
docs: add k3s kubeconfig permissions note to devops skill
After system reboot, k3s kubeconfig at /etc/rancher/k3s/k3s.yaml reverts to restrictive permissions, breaking kubectl. Document the fix (sudo chmod 644) and general permission gotchas.
1 parent f523b46 commit df0ae8f

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

  • claude-code/shared/skills/devops

claude-code/shared/skills/devops/SKILL.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,24 @@ Kubernetes deployment, container management, and CI/CD operations for the SmartE
2121

2222
### Local Development Cluster
2323

24+
**Known issue: k3s kubeconfig permissions**
25+
26+
k3s is installed with tight permissions on the kubeconfig file. After every system reboot, `kubectl` commands will fail with:
27+
28+
```
29+
error: error loading config file "/etc/rancher/k3s/k3s.yaml": permission denied
30+
```
31+
32+
Fix by running (requires sudo):
33+
34+
```bash
35+
sudo chmod 644 /etc/rancher/k3s/k3s.yaml
36+
```
37+
38+
If you encounter this error, advise the user to run the above command. Other permission-related issues may also surface with k3s (e.g. node token permissions, containerd socket access). These are typically resolved with similar `chmod` or group membership adjustments after reboot.
39+
40+
**Cluster management:**
41+
2442
```bash
2543
cd repos/DiamondLightSource/smartem-decisions
2644

0 commit comments

Comments
 (0)