diff --git a/README.md b/README.md
new file mode 100644
index 00000000..1e694906
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+# pmbootstrap
+Sophisticated chroot/build/flash tool, to develop and install [postmarketos](https://ollieparanoid.github.io/post/postmarketOS).
+
+
+## Requirements
+* GNU/Linux
+* Python 3
+* openssh
+
+
+## Usage
+Run `pmbootstrap init` first, to select a target device and the work folder, which will contain all the chroots and other data.
+After that, you can run any command. All dependencies (e.g. chroots) will be installed automatically, if they are not available yet.
+
+Here are some examples:
+
+
+`pmbootstrap --help`:
+List all available commands
+
+`pmbootstrap log`:
+Run tail -f on the logfile, which contains detailed output. Do this in a second terminal, while executing another `pmbootstrap` command to get all the details.
+
+`pmbootstrap chroot`:
+Open a shell inside a native Alpine Linux chroot (~6 MB install size).
+
+`pmbootstrap chroot --suffix=buildroot_armhf`:
+Open a shell inside an `armhf` Alpine Linux chroot, with qemu user mode emulation and binfmt support automatically set up.
+
+`pmbootstrap build heimdall`:
+Build the "heimdall" package (specify any package from the `aports`-folder here).
+
+`pmbootstrap build heimdall --arch=armhf`:
+Build the "heimdall" package for `armhf` inside the `armhf` chroot, with the cross-compiler installed in the native chroot (chroots are connected via distcc).
+
+`pmbootstrap install`:
+Generate a system image file with a full postmarketOS installation. All required packages get built first, if they do not exist yet. You will get asked for the "user" password and the root partition password.
+
+`pmbootstrap install --sdcard=/dev/mmcblk0`:
+Format and partition the SD card `/dev/mmcblk0`, and put a full postmarketOS installation on it
+
+
+## Testsuite
+Simply install pytest (via your package manager or via pip) and run it inside the pmbootstrap folder.