diff --git a/website/docs/getting-started/installation.md b/website/docs/getting-started/installation.md
index 7b4933c8242..fbfee0c10db 100644
--- a/website/docs/getting-started/installation.md
+++ b/website/docs/getting-started/installation.md
@@ -94,7 +94,7 @@ You do **not** need to install Python, Node.js, ripgrep, or ffmpeg manually. The
 :::
 
 :::tip Nix users
-If you use Nix (on NixOS, macOS, or Linux), there's a dedicated setup path with a Nix flake, declarative NixOS module, and optional container mode. See the **[Nix & NixOS Setup](./nix-setup.md)** guide.
+Nix is **no longer an explicitly supported install path** (best-effort only). If you already use Nix (on NixOS, macOS, or Linux), there's a dedicated setup path with a Nix flake, declarative NixOS module, and optional container mode. See the **[Nix & NixOS Setup](./nix-setup.md)** guide.
 :::
 
 ---
diff --git a/website/docs/getting-started/nix-setup.md b/website/docs/getting-started/nix-setup.md
index 3cfdd86fd29..b89fa9c05da 100644
--- a/website/docs/getting-started/nix-setup.md
+++ b/website/docs/getting-started/nix-setup.md
@@ -6,6 +6,10 @@ description: "Install and deploy Hermes Agent with Nix — from quick `nix run`
 
 # Nix & NixOS Setup
 
+:::warning No longer explicitly supported
+Nix and NixOS are **no longer an explicitly supported install path** for Hermes Agent. The flake and NixOS module documented here may lag behind `main` and are maintained on a best-effort basis. For a supported setup, use the standard [installation](./installation.md) path (`curl | bash` installer, Docker, or Windows). This page is kept for users already running on Nix.
+:::
+
 Hermes Agent ships a Nix flake with three levels of integration:
 
 | Level | Who it's for | What you get |
diff --git a/website/docs/getting-started/updating.md b/website/docs/getting-started/updating.md
index ae1ba843708..33b5f197468 100644
--- a/website/docs/getting-started/updating.md
+++ b/website/docs/getting-started/updating.md
@@ -215,7 +215,7 @@ Rolling back may cause config incompatibilities if new options were added. Run `
 
 ### Note for Nix users
 
-If you installed via Nix flake, updates are managed through the Nix package manager:
+Nix is no longer an explicitly supported install path (best-effort only) — see [Nix Setup](./nix-setup.md). If you installed via Nix flake, updates are managed through the Nix package manager:
 
 ```bash
 # Update the flake input
diff --git a/website/docs/guides/build-a-hermes-plugin.md b/website/docs/guides/build-a-hermes-plugin.md
index 5793c89a9fb..eacbec0174f 100644
--- a/website/docs/guides/build-a-hermes-plugin.md
+++ b/website/docs/guides/build-a-hermes-plugin.md
@@ -1196,6 +1196,10 @@ pip install hermes-plugin-calculator
 
 ## Distribute for NixOS
 
+:::warning Nix is no longer explicitly supported
+Nix/NixOS is no longer an explicitly supported install path (best-effort only) — see [Nix Setup](/getting-started/nix-setup). This section is kept for users already deploying on NixOS.
+:::
+
 NixOS users can install your plugin declaratively if you provide a `pyproject.toml` with entry points:
 
 **Entry-point plugins** (recommended for distribution):