diff --git a/docs/TROUBLESHOOTING_UDEV.md b/docs/TROUBLESHOOTING_UDEV.md new file mode 100644 index 0000000..619bf0c --- /dev/null +++ b/docs/TROUBLESHOOTING_UDEV.md @@ -0,0 +1,17 @@ +# Operating systems without udev + +Some operating systems do not come with `udev` out of the box, for example Alpine Linux. In these instances you will not be able to bind `/run/udev` to the container for sharing device metadata. Some operating systems offer `udev` as a package that can be installed separately, or an alternative (such as `eudev` in the case of Alpine Linux) that provides the same functionality. + +To install `eudev` in Alpine Linux (run as root): + +``` +apk add eudev +``` + +Once your `udev` implementation is installed, create `/run/udev` with the following command: + +``` +udevadm trigger +``` + +On Alpine Linux, this also has the benefit of creating symlinks to device serial numbers in `/dev/disk/by-id`.