From 5cd441da7ba446757d6ca64ae78bba142e223571 Mon Sep 17 00:00:00 2001
From: Matthew Kobayashi <matthew@kobayashi.au>
Date: Fri, 29 Jul 2022 09:33:55 +1000
Subject: [PATCH] Add udev troubleshooting doc

---
 docs/TROUBLESHOOTING_UDEV.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 docs/TROUBLESHOOTING_UDEV.md

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`.