diff --git a/installation/armbian.md b/installation/armbian.md
new file mode 100644
index 000000000..be11e9d64
--- /dev/null
+++ b/installation/armbian.md
@@ -0,0 +1,81 @@
+---
+layout: documentation
+title: Armbian
+---
+
+{% include base.html %}
+
+# Armbian
+
+## What is Armbian?
+
+Armbian is a base operating system platform for single board computers.
+
+- comes in desktop, minimal or server variant,
+- has clean and highly optimised user space,
+- is Ubuntu and Debian compatible,
+- is supported with vibrant community,
+- comes with a powerful SDK which allows reproduction and customisation,
+- supports many 3rd party wireless drivers with advanced functionalities,
+- supports Docker, disk encryption, Wireguard VPN any many other features.
+
+## Recommended hardware
+
+OpenHab will run on any Armbian [supported hardware](https://www.armbian.com/download/?device_support=Supported) but it is recommended to choose boards that have at least:
+
+
+- 512 Kb of memory (on minimal or server image)
+- eMMC or a [quality SD card](https://docs.armbian.com/User-Guide_Getting-Started/#how-to-prepare-a-sd-card)
+- 4 core
+- wired networking
+
+
+![Armbian](images/boards1.png)
+
+## Supported images
+
+You can [download](https://www.armbian.com/download/?device_support=Supported) and use server, desktop or minimal. If you choose a minimal image, you need to install armbian-config first.
+
+## Setup
+
+**First Steps:**
+
+1. Prepare Armbian as usual - [login as root / 1234, change root password, create username. You don't need to perform any other steps](https://docs.armbian.com/User-Guide_Getting-Started/).
+
+2. Update
+
+```shell
+sudo apt-get update
+sudo apt-get upgrade
+```
+
+3. Run armbian-config
+
+```shell
+sudo armbian-config
+```
+
+![Armbian config](images/armbian-step1.png)
+![System and 3rd party software](images/armbian-step2.png)
+![Softy](images/armbian-step3.png)
+
+Select OpenHAB with **SPACE** and press **ENTER**
+
+![Openhab](images/armbian-step4.png)
+
+Wait 5 to 10 minutes depending on your hardware. During this time you can leave armbian-config and check if installation was succesfull by checking what openhab is doing on the system:
+
+```shell
+sudo htop -u openhab
+```
+
+![Observe activities with htop](images/armbian-step5.png)
+
+If you don't see any openhab activities, something went wrong.
+
+## Help
+
+The very active [openHAB Community Forum](https://community.openhab.org) provides many more details and hints.
+If you run into any problems, use the search function or open a new thread with your detailed question.
+
+In case you run into a problem that is board hardware related, please use [Armbian Community forums](https://forum.armbian.com/forum/1-bug-tracker/).
diff --git a/installation/images/armbian-step1.png b/installation/images/armbian-step1.png
new file mode 100644
index 000000000..cab94b0aa
Binary files /dev/null and b/installation/images/armbian-step1.png differ
diff --git a/installation/images/armbian-step2.png b/installation/images/armbian-step2.png
new file mode 100644
index 000000000..81394e80a
Binary files /dev/null and b/installation/images/armbian-step2.png differ
diff --git a/installation/images/armbian-step3.png b/installation/images/armbian-step3.png
new file mode 100644
index 000000000..a68e76f6a
Binary files /dev/null and b/installation/images/armbian-step3.png differ
diff --git a/installation/images/armbian-step4.png b/installation/images/armbian-step4.png
new file mode 100644
index 000000000..4fbcf7ca3
Binary files /dev/null and b/installation/images/armbian-step4.png differ
diff --git a/installation/images/armbian-step5.png b/installation/images/armbian-step5.png
new file mode 100644
index 000000000..3a4df7572
Binary files /dev/null and b/installation/images/armbian-step5.png differ
diff --git a/installation/images/boards1.png b/installation/images/boards1.png
new file mode 100644
index 000000000..01fa4cf36
Binary files /dev/null and b/installation/images/boards1.png differ