diff --git a/kernel-rs/README.md b/kernel-rs/README.md
index 1aad36dc..f68da820 100644
--- a/kernel-rs/README.md
+++ b/kernel-rs/README.md
@@ -4,7 +4,21 @@ based on [Writing an OS in rust](https://os.phil-opp.com/)
 
 ## dependencies
 
-for archlinux `pacman -S make grub2 xorriso mtools binutils`
+  - `nasm` compiles the bootcode
+  - `ld` links the bootcode
+  - `grub-mkrescue` builds the iso
+  - `xargo` builds rust code
+  - `qemu` runs the iso
+
+on archlinux `pacman -S make grub2 xorriso mtools binutils gcc qemu`
+
+## rust setup
+
+```
+pacman -S rustup
+rustup component add rust-src
+cargo install xargo
+```
 
 ## docker
 a standard development environment can be invoked: