From 89b3cf78fd7af80e4dce4bfa9b3e6120e8d323e0 Mon Sep 17 00:00:00 2001
From: Karolis Labrencis <karolis@labrencis.lt>
Date: Tue, 2 Nov 2021 23:42:38 +0200
Subject: [PATCH] Document using deploy-rs to deploy home-manager

---
 doc/integrations/deploy.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/doc/integrations/deploy.md b/doc/integrations/deploy.md
index 642267c..2282eb7 100644
--- a/doc/integrations/deploy.md
+++ b/doc/integrations/deploy.md
@@ -45,5 +45,32 @@ deploy '.#hostName' --hostname host.example.com
 
 > ##### _Note:_
 > Your user will need **passwordless** sudo access
+### Home Manager
+
+Digga's `lib.mkDeployNodes` provides only `system` profile.
+In order to deploy your `home-manager` configuration you should provide additional profile(s) to deploy-rs config:
+```nix
+# Initially, this line looks like this: deploy.nodes = digga.lib.mkDeployNodes self.nixosConfigurations { };
+deploy.nodes = digga.lib.mkDeployNodes self.nixosConfigurations
+  {
+    <HOSTNAME> = {
+      profilesOrder = [ "system" "<HM_PROFILE>" "<ANOTHER_HM_PROFILE>"];
+      profiles.<HM_PROFILE> = {
+        user = "<YOUR_USERNAME>";
+        path = deploy.lib.x86_64-linux.activate.home-manager self.homeConfigurationsPortable.x86_64-linux.<YOUR_USERNAME>;
+      };
+      profiles.<ANOTHER_HM_PROFILE> = {
+        user = "<ANOTHER_USERNAME>";
+        path = deploy.lib.x86_64-linux.activate.home-manager self.homeConfigurationsPortable.x86_64-linux.<ANOTHER_USERNAME>;
+      };
+    };
+  };
+```
+
+Substitute `<HOSTNAME>`, `<HM_PROFILE>` and `<YOUR_USERNAME>` placeholders (omitting the `<>`). 
+
+`<ANOTHER_HM_PROFILE>` is there to illustrate deploying multiple `home-manager` configurations. Either substitute those as well,
+or remove them altogether. Don't forget the `profileOrder` variable.
+
 
 [d-rs]: https://github.com/serokell/deploy-rs