diff --git a/docs/LocalBuilds.txt b/docs/LocalBuilds.txt
new file mode 100644
index 0000000..c1da2e4
--- /dev/null
+++ b/docs/LocalBuilds.txt
@@ -0,0 +1,34 @@
+                       Local builds in ~/data/opt
+
+
+Introduction
+
+   On machines without root access, or without a package manager (such
+   as MacOS), it can be useful to build applications into the home
+   directory.
+
+
+1. Basic applications
+
+   Most applications can be installed with the following triplet:
+
+      ./configure --prefix=$HOME/data/opt/app
+      make -j4
+      make -j4 install
+
+
+2. Applications with extra libraries
+
+   If an application needs extra libraries, these can be installed into
+   the app directory first, with the same commands as above.
+
+   When the main application is built, you will need to tell the build
+   system and the application where to find the libraries. This is done
+   as so:
+
+      app=$HOME/data/opt/app
+      ./configure --prefix=$app \
+                  CFLAGS="-I$app/include" \
+                  LDFLAGS="-L$app/lib -Wl,-rpath $app/lib"
+      make -j4
+      make -j4 install
diff --git a/roles/home-cli/files/virt-install.txt b/docs/VirtInstall.txt
similarity index 100%
rename from roles/home-cli/files/virt-install.txt
rename to docs/VirtInstall.txt