You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/troubleshoot.md
+42
Original file line number
Diff line number
Diff line change
@@ -169,3 +169,45 @@ To solve this problem, load the Nestybox Shiftfs module as described [here](http
169
169
Note that normally the Sysboxd installer loads this module into the
170
170
kernel, so this error implies that either the installer did not
171
171
succeed or that the module was somehow unloaded since then.
172
+
173
+
## Unprivileged User Namespace Creation Error
174
+
175
+
When creating a system container, Docker may report the following error:
176
+
177
+
```bash
178
+
docker run --runtime=sysbox-runc -it ubuntu:latest
179
+
docker: Error response from daemon: OCI runtime create failed: host is not configured properly: kernel is not configured to allow unprivileged users to create namespaces: /proc/sys/kernel/unprivileged_userns_clone: want 1, have 0: unknown.
180
+
```
181
+
182
+
This means that the host's kernel is not configured to allow unprivileged users
183
+
to create user namespaces.
184
+
185
+
For Ubuntu, fix this with:
186
+
187
+
```
188
+
sudo sh -c "echo 1 > /proc/sys/kernel/unprivileged_userns_clone"
189
+
```
190
+
191
+
**Note:** The Sysboxd package installer automatically executes this
192
+
instruction, so normally there is no need to do this configuration
193
+
manually.
194
+
195
+
## Failed to Setup Docker Volume Manager Error
196
+
197
+
When creating a system container, Docker may report the following error:
198
+
199
+
```bash
200
+
docker run --runtime=sysbox-runc -it ubuntu:latest
201
+
docker: Error response from daemon: OCI runtime create failed: failed to setup docker volume manager: host dir for docker store /var/lib/sysboxd/docker can't be on ..."
202
+
```
203
+
204
+
This means that directory `/var/lib/sysboxd` is on a filesystem not supported by Sysboxd.
205
+
206
+
This directory must be on one of the following filesystems:
207
+
208
+
* ext4
209
+
* btrfs
210
+
211
+
The same requirement applies to the `/var/lib/docker` directory.
212
+
213
+
This is normally the case for vanilla Ubuntu installations.
0 commit comments