diff --git a/README.md b/README.md
index e89963e..baca357 100755
--- a/README.md
+++ b/README.md
@@ -22,10 +22,12 @@
 
 + :house_with_garden: [home](home)
 + :computer: [hosts](hosts)
+  - :wind_chime: [kariru](hosts/kariru)
   - :cherry_blossom: [sakura](hosts/sakura)
-  - :white_flower: [sutakku](hosts/sutakku)
   - :full_moon: [tsuki](hosts/tsuki)
 + :electric_plug: [modules](modules)
+  - :satellite: [services](modules/services)
+    - :anchor: [arr](modules/services/arr)
 + :package: [pkgs](pkgs)
 + :lock: [secrets](secrets)
 
diff --git a/home/README.md b/home/README.md
index 8ed5d35..c10da80 100644
--- a/home/README.md
+++ b/home/README.md
@@ -5,7 +5,7 @@ the home of my dotfiles, configured and managed by home-manager.
 name            | description
 --------------- | -----------
 `direnv`        | a shell extension, that loads environment variables in certain directories
-`default.nix`   | used for commonly shared modules, for multiple home-manager configs
+`default`       | used for commonly shared modules, for multiple home-manager configs
 `dunst`         | notification daemon
 `git`           | version control system
 `gtk`           | themes
diff --git a/hosts/README.md b/hosts/README.md
index ac75154..42b9030 100644
--- a/hosts/README.md
+++ b/hosts/README.md
@@ -4,6 +4,8 @@ my different hosts, each with their own unique configurations and purposes.
 
 Name            | Description
 --------------- | -----------
-`sakura`        | my WIP new main vm
-`sutakku`       | (currently) my *arr stack / seedbox vm
-`tsuki`         | my main machine running hyprland
\ No newline at end of file
+`kariru`        | *arr stack / seedbox vm
+`sakura`        | WIP new main vm
+`tsuki`         | main machine running hyprland
+`default`       | defines `nixosConfigurations`
+`deploy`        | defines deployment nodes for deploy-rs
diff --git a/modules/README.md b/modules/README.md
index 768bde9..03be745 100644
--- a/modules/README.md
+++ b/modules/README.md
@@ -4,15 +4,16 @@ this directory hosts some common modules / services / security tweaks used on (m
 
 name            | description
 --------------- | -----------
-`services`      | houses my oci containers
+`services`      | houses my oci containers, and other services
 `default`       | used for commonly shared modules
 `fonts`         | font handling
 `greetd`        | login manager
 `networking`    | common network configuration
 `nix`           | common nix configuration
+`openssh`       | configures openssh options
 `security`      | stolen from [hlissner](https://github.com/hlissner)
 `sops`          | configures sops-nix
 `swayidle`      | idle manager daemon
 `system.nix`    | commonly shared system settings
-`udevd`         | fixes an issue when using `nixos-rebuild`, tracked [here](https://github.com/NixOS/nixpkgs/issues/180175)
+`users.nix`     | defines all hosts users & groups
 `virtualisation`| basic docker configuration
\ No newline at end of file