1 files changed, 35 insertions, 0 deletions
diff --git a/README.md b/README.md
index e7a95b7..610573f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,38 @@
 ```bash
 stow -v -t ~ nix nixpkgs
 ```
+
+OrbStack usage:
+1. Create a debian 12 machine with the name `orb-deb` and user `kdma0` (default).
+2. Specify the follwing ``cloud-init.yaml`:
+```
+#cloud-config
+
+users:
+  - name: kdam0
+    homedir: /home/kdam0
+    sudo: ["ALL=(ALL) NOPASSWD:ALL"]
+    groups: users, admin
+
+package_update: true
+packages:
+  - curl
+  - git
+  - stow
+  - xz-utils
+
+write_files:
+- content: |
+    #!/bin/bash
+    HOME="/home/kdam0" sh <(curl -L https://nixos.org/nix/install) --daemon --yes
+  path: /run/installer
+  permissions: '0755'
+
+runcmd:
+  - /run/installer
+  - su - kdam0 -c 'git clone "https://gitlab.com/kdam0/dotfiles-nix.git"'
+  - su - kdam0 -c 'cd dotfiles-nix && stow -v -t ~ nix home-manager'
+  - su - kdam0 -c 'nix run home-manager/master switch'
+  - chsh -s /home/kdam0/.nix-profile/bin/zsh kdam0
+  - echo "machine is ready for use!"
+```