From 53d8295fc31aa482dbd2a5f8c1a9fcebcfff18a1 Mon Sep 17 00:00:00 2001
From: Axon <axon@openmailbox.org>
Date: Tue, 26 May 2015 13:41:11 +0000
Subject: [PATCH] Created instructions for storing AppVMs on secondary drives.

---
 SecondaryStorage.md | 41 +++++++++++++++++++++++++++++++++++++++++
 UserDoc.md          |  1 +
 2 files changed, 42 insertions(+)
 create mode 100644 SecondaryStorage.md

diff --git a/SecondaryStorage.md b/SecondaryStorage.md
new file mode 100644
index 00000000..e0149738
--- /dev/null
+++ b/SecondaryStorage.md
@@ -0,0 +1,41 @@
+---
+layout: doc
+title: SecondaryStorage
+permalink: /doc/SecondaryStorage/
+redirect_from: /wiki/SecondaryStorage/
+---
+
+Storing AppVMs on Secondary Drives
+==================================
+
+Suppose you have a fast but small primary SSD and a large but slow secondary
+HDD.  You want to store a subset of your AppVMs on the HDD. In dom0:
+
+1. `# mv /var/lib/qubes/appvms/my-new-appvm
+/path/to/secondary/drive/my-new-appvm`
+
+2. `# ln -s /path/to/secondary/drive/my-new-appvm /var/lib/qubes/appvms/`
+
+Now, `my-new-appvm` will behave as if it were still stored on the primary SSD
+(except that it will probably be slower, since it's actually stored on the
+secondary HDD).
+
+Known Issues
+------------
+
+ * The above procedure does **not** interfere with [Qubes Backup][]. However,
+   attempting to symlink a `private.img` file (rather than the whole AppVM
+   directory) is known to prevent the `private.img` file from being backed up.
+   The same problem may occur if the above procedure is attempted on a
+   [TemplateVM][]. [[1]]
+
+ * After implementing the above procedure, starting `my-new-appvm` will cause
+   dom0 notifications to occur stating that loop devices have been attached to
+   dom0. This is normal. (No untrusted devices are actually being mounted to
+   dom0.) Do not attempt to detach these disks. (They will automatically be
+   detached when you shut down the AppVM.) [[2]]
+
+[Qubes Backup]: https://www.qubes-os.org/doc/BackupRestore/
+[TemplateVM]: https://www.qubes-os.org/doc/Templates/
+[1]: https://groups.google.com/d/topic/qubes-users/EITd1kBHD30/discussion
+[2]: https://groups.google.com/d/topic/qubes-users/nDrOM7dzLNE/discussion
diff --git a/UserDoc.md b/UserDoc.md
index 3a18df2f..3e5417ab 100644
--- a/UserDoc.md
+++ b/UserDoc.md
@@ -24,6 +24,7 @@ Qubes User Documentation
         2.  [XFCE Installation in dom0](/doc/UserDoc/XFCE/)
         3.  [Installing ZFS in Qubes](/doc/ZFS/)
         4.  [Configuring YubiKey for user authentication](/doc/YubiKey/)
+        5.  [Storing AppVMs on Secondary Drives](/doc/SecondaryStorage/)
     7.  External Links
         1.  [Customizing the GUI experience with KDE](https://groups.google.com/d/topic/qubes-users/KhfzF19NG1s/discussion)