diff --git a/machines/raven/README.md b/machines/raven/README.md
new file mode 100644
index 0000000..c58a99d
--- /dev/null
+++ b/machines/raven/README.md
@@ -0,0 +1,22 @@
+# raven
+
+## setup
+
+```bash
+parted -s /dev/sda -- \
+    mktable GPT \
+    mkpart primary fat32 1MiB 1GiB \
+    set 1 esp on \
+    mkpart primary ext2 1GiB 100%
+
+mkfs.vfat -i 0FEAFAF6 /dev/sda1
+
+cryptsetup luksFormat --type luks2 --uuid=ad04bc72-bc84-42e3-856f-152c162ad88c /dev/sda2
+cryptsetup open --type luks2 /dev/sda2 cryptroot
+
+mkfs.btrfs -U 1ac13504-fb49-4739-a0e3-f87a3f840fb1 /dev/mapper/cryptroot
+
+mount -o compress=zstd /dev/mapper/cryptroot /mnt
+mkdir /mnt/boot /boot
+mount /dev/sda1 /boot
+```