Skip to content
This repository was archived by the owner on Dec 15, 2025. It is now read-only.

Commit 42ea5e3

Browse files
Updated troubleshooting tips. (#61)
Included the solution to the cgroup issue.
1 parent b143e4d commit 42ea5e3

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

docs/Troubleshooting.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,22 @@ Changes in files on your host not being reflected in the container(s) can have a
55
If your files are not updating you should check the [maximum permitted `inotify` watchers](install#inotify-watcher-limit).
66
### Text editor
77
The way some editors behave on save means the inumber of the file does not change, so unison does not pick up a difference and the files in your containers do not update. Notable culprits are `vim` and `Atom`. In both cases there are fixes - for example the `local-history` plugin for `Atom` forces it to behave as we need. If you have mysterious issues with files not changing in your containers and it isn't the `inotify` watcher limit above, check how your editor behaves.
8+
9+
## Cgroup Issues
10+
If your ce-dev is failing to even start the controller then you'll see a response that looks like this.
11+
```
12+
Creating ce_dev_controller ... done
13+
Ensure user UID match those on the host...
14+
Ensure user UID match those on the host... !
15+
Error: Command failed: sudo docker exec ce_dev_controller /bin/sh /opt/ce-dev-ownership.sh 1000 1000
16+
```
17+
There will be very little in the way of logs or errors from this. Just an indication of a problem.
18+
19+
It turns out that if you are using Ubuntu 21.10 (or POP! OS) then it will be using kernelstub and not grub. This might create incompatabilities between docker and cgroup version 2. To fix this you need to run the following commands.
20+
21+
```
22+
sudo kernelstub -a "systemd.unified_cgroup_hierarchy=0"
23+
sudo update-initramfs -c -k all
24+
```
25+
26+
They will take a while to run (about 10 minutes), but once complete reboot your machine and delete any created containers that velong to the ce_dev image. When you rebuild the ce-dev controller (by running any command) it should create fine.

0 commit comments

Comments
 (0)