diff --git a/Documentation/boards/raspberrypi.mk b/Documentation/boards/raspberrypi.md
similarity index 100%
rename from Documentation/boards/raspberrypi.mk
rename to Documentation/boards/raspberrypi.md
diff --git a/Documentation/configuration.md b/Documentation/configuration.md
new file mode 100644
index 000000000..20a2dd53d
--- /dev/null
+++ b/Documentation/configuration.md
@@ -0,0 +1,29 @@
+# Configuration
+
+## Automatic
+
+You can format a USB stick with FAT32 and name it with `hassos-config`. The layout could be look like:
+```
+network/
+modules/
+known_hosts
+hassos-xy.rauc
+```
+
+- On `network` folder can hold any kind of NetworkManager connections files.
+- The folder `modules` is for modules-load configuration files.
+- `known_hosts` file activate debug SSH access of port `22222`.
+- For firmware updates you can but the `hassos-*.rauc` OTA update they should be install. 
+
+## Local
+
+### Bootargs
+
+You can edit or create a `cmdline.txt` into your boot partition. That will be read from our bootloader.
+
+### Kernel-Module
+
+The kernel module folder `/etc/modules-load.d` is persistent and you can add your config files there. See [Systemd modules load][systemd-modules].
+
+
+[systemd-modules]: https://www.freedesktop.org/software/systemd/man/modules-load.d.html
diff --git a/Documentation/configuration.mk b/Documentation/configuration.mk
deleted file mode 100644
index a56f8030a..000000000
--- a/Documentation/configuration.mk
+++ /dev/null
@@ -1,12 +0,0 @@
-# Configuration
-
-## Bootargs
-
-You can edit or create a `cmdline.txt` into your boot partition. That will be read from our bootloader.
-
-## Kernel-Module
-
-The kernel module folder `/etc/modules-load.d` is persistent and you can add your config files there. See [Systemd modules load][systemd-modules].
-
-
-[systemd-modules]: https://www.freedesktop.org/software/systemd/man/modules-load.d.html
diff --git a/README.md b/README.md
index 6f3870ab0..d20df8d87 100644
--- a/README.md
+++ b/README.md
@@ -15,14 +15,6 @@ Hass.io OS based on [buildroot](https://buildroot.org/). It's a hypervisor for D
 ## Schemas
 ![](misc/hassio-os-partition.png?raw=true)
 
-## Configuration
-
-Create a USB stick with a partition named "hassos-config". This partition can include follow files:
-
-- network-* (NetworkManager keyfiles)
-- known_hosts (SSH)
-- hassos*.ota (Firmware updates)
-
 # Customize
 
 Provide a file with the name `hassos.json` in your data partition and the following structure: