diff --git a/in/index.rst b/in/index.rst
index 4635cde..874fb16 100644
--- a/in/index.rst
+++ b/in/index.rst
@@ -16,6 +16,7 @@ RTFD
    public/network/index
    public/packages/index
    public/security/index
+   public/storage/index
    public/systems/index
    public/versions/index
    public/web/index
diff --git a/in/public/storage/index.rst b/in/public/storage/index.rst
new file mode 100644
index 0000000..c2eef59
--- /dev/null
+++ b/in/public/storage/index.rst
@@ -0,0 +1,7 @@
+Storage
+=======
+
+.. toctree::
+   :maxdepth: 2
+
+   mdadm/index
diff --git a/in/public/storage/mdadm/creation.rst b/in/public/storage/mdadm/creation.rst
new file mode 100644
index 0000000..4211bfb
--- /dev/null
+++ b/in/public/storage/mdadm/creation.rst
@@ -0,0 +1,31 @@
+Creation
+========
+
+.. warning::
+
+ Only use partitions, never whole devices,
+ otherwise assembly will fail after reboot!
+
+RAID 0
+------
+
+.. code:: shell
+
+ mdadm --create /dev/md0 --level=0 \
+ --raid-devices=2 /dev/sd[bc]1
+
+RAID 1
+------
+
+.. code:: shell
+
+ mdadm --create /dev/md0 --level=1 \
+ --raid-devices=2 /dev/sd[bc]1
+
+RAID 5
+------
+
+.. code:: shell
+
+ mdadm --create /dev/md0 --level=5 \
+ --raid-devices=3 /dev/sd[b-d]1
diff --git a/in/public/storage/mdadm/index.rst b/in/public/storage/mdadm/index.rst
new file mode 100644
index 0000000..6dfc732
--- /dev/null
+++ b/in/public/storage/mdadm/index.rst
@@ -0,0 +1,8 @@
+MDadm (MultiDisk admin)
+=======================
+
+.. toctree::
+
+ creation
+ persistence
+ manual
diff --git a/in/public/storage/mdadm/manual.rst b/in/public/storage/mdadm/manual.rst
new file mode 100644
index 0000000..79aaffe
--- /dev/null
+++ b/in/public/storage/mdadm/manual.rst
@@ -0,0 +1,27 @@
+Manual operations
+=================
+
+.. note::
+
+ Use --scan to refer to all known devices
+
+Details
+-------
+
+.. code:: shell
+
+ mdadm --detail /dev/md0
+
+Stop
+----
+
+.. code:: shell
+
+ mdadm --stop /dev/md0
+
+Assemble
+--------
+
+.. code:: shell
+
+ mdadm --assemble /dev/md0
diff --git a/in/public/storage/mdadm/persistence.rst b/in/public/storage/mdadm/persistence.rst
new file mode 100644
index 0000000..5dfcdac
--- /dev/null
+++ b/in/public/storage/mdadm/persistence.rst
@@ -0,0 +1,14 @@
+Persistence
+===========
+
+* reference the device in configuration
+
+.. code:: shell
+
+ mdadm --detail --scan /dev/md0 >> /etc/mdadm/mdadm.conf
+
+* update the initial file system
+
+.. code:: shell
+
+ update-initramfs -u