Unverified Commit ddb8212a authored by boklm's avatar boklm
Browse files

Bug 40298: Add documentation about subuid and subgid

parent aa65127f
......@@ -53,6 +53,12 @@ To enable them you can use the following command as root:
You can enable them permanently by adding the setting to /etc/sysctl.d/
The user you use to build needs to have a range of subordinate uids and
gids in /etc/subuid and /etc/subgid. Most of the time they are added by
default when the user is created. If it was not the case, you can use
usermod(8) with the --add-subuids and --add-subgids options. See also
the subuid(5) and subgid(5) man pages.
Starting a build
----------------
......
......@@ -43,3 +43,22 @@ rm /etc/resolv.conf
Restart network-manager
sudo service network-manager restart
Could not find uid in /etc/subuid
---------------------------------
In some cases you can have the error:
Error: Error starting remote:
Error: Could not find uid in /etc/subuid
Error: failed to set uidmap
The user you use to build needs to have a range of subordinate uids and
gids in /etc/subuid and /etc/subgid. Most of the time they are added by
default when the user is created. If it was not the case, you can use
usermod(8) with the --add-subuids and --add-subgids options. See also
the subuid(5) and subgid(5) man pages.
Note that the root user is not exempted from the requirement for a
valid /etc/subuid and /etc/subgid entry, if you are building as root.
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment