docs: finalize next release docs

1 files changed, 31 insertions, 0 deletions

diff --git a/website/src/content/docs/install.mdx b/website/src/content/docs/install.mdx
index dda2dc27..9852b0f1 100644
--- a/website/src/content/docs/install.mdx
+++ b/website/src/content/docs/install.mdx
@@ -33,6 +33,37 @@ Herdr checks for new releases and notifies you in the app. You can update manual
 herdr update
 ```
 
+## Install with Nix
+
+If you already use Nix, Herdr provides a flake that builds Herdr from source:
+
+```bash
+nix run github:ogulcancelik/herdr/v0.x.y
+nix build github:ogulcancelik/herdr/v0.x.y
+nix profile install github:ogulcancelik/herdr/v0.x.y
+```
+
+Replace `v0.x.y` with the latest release tag. You can omit the tag to track `master`, but release tags are recommended for normal installs.
+
+The flake also exposes a development shell:
+
+```bash
+nix develop github:ogulcancelik/herdr
+```
+
+Update through the same Nix workflow you used to install Herdr. For a profile install, list your profile entries and upgrade the Herdr entry:
+
+```bash
+nix profile list
+nix profile upgrade <index-or-name>
+```
+
+If Herdr is an input in your own flake, update that input and rebuild your system, Home Manager, or development environment:
+
+```bash
+nix flake update herdr
+```
+
 ## Download manually
 
 You can also download a binary from [GitHub releases](https://github.com/ogulcancelik/herdr/releases).