1 files changed, 24 insertions, 0 deletions
diff --git a/Biz/Dev.md b/Biz/Dev.md
index 6d793c9..f2aef0e 100644
--- a/Biz/Dev.md
+++ b/Biz/Dev.md
@@ -27,6 +27,8 @@ Jump into a development shell:
 
 Then run  `help` to see the dev commands.
 
+# Repository organization
+
 The source tree maps to the module namespace, and roughly follows the
 Haskell namespace hierarchy (although nothing is enforced). The main
 'common' space is `Biz`, other namespaces should be related to their
@@ -59,3 +61,25 @@ handle the file. So for example:
   this, but we use them to make plans and such
 - `.jnl` is a journal for accounting, the build system will check our
   balances, make sure we're profitable
+
+# Setting up remote builds
+
+The Biz.Dev machine acts as a remote build server and Nix cache. To use it from
+your local machine, your public key must be at `Biz/Keys/$USER.pub` and your
+user added to `Biz/Users.nix`, then bild will automatically use your key to run
+builds on Biz.Dev.
+
+To use distributed builds for all nix commands, add the following to your NixOS
+configuration:
+
+    nix = {
+      distributedBuilds = true;
+      buildMachines = [
+        {
+          hostName = "dev.simatime.com";
+          sshUser = "yourUserName";
+          sshKey = "/path/to/your/private/key";
+          system = "x86_64-linux";
+        }
+      ];
+    };