diff --git a/README.md b/README.md
index 200f9d1..b6d6e85 100644
--- a/README.md
+++ b/README.md
@@ -232,6 +232,40 @@ npm start
+
+Nix
+
+**Flake** (NixOS or flake-enabled systems):
+
+```nix
+{
+ inputs.troutbot.url = "github:notashelf/troutbot";
+
+ outputs = { self, nixpkgs, troutbot }: {
+ nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
+ modules = [
+ troutbot.nixosModules.troutbot
+ {
+ services.troutbot = {
+ enable = true;
+ environmentFile = "/path/to/.env"; # use Agenix if possible
+ configPath = "/path/to/config.ts" # use Agenix if possible
+ };
+ }
+ ];
+ };
+ };
+};
+```
+
+**Run directly**:
+
+```bash
+nix run github:notashelf/troutbot
+```
+
+
+
Docker