diff --git a/README.md b/README.md
new file mode 100644
index 0000000..24a8ee7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# GPGol.js
+
+This project provides a GnuPG integration for users of Outlook Web.
+
+## Build it (Linux)
+
+If you distribution provides a sufficient up to date version of the KDE
+Frameworks 6 and QGpgME, the easiest is to install the development package from
+your package manager. Otherwise, you can build all the dependencies yourself with
+[kdesrc-build](https://community.kde.org/Get_Involved/development).
+
+Then clone and build gpgol.js:
+
+```sh
+git clone https://dev.gnupg.org/source/gpgol.js.git
+cd gpgol.js
+cmake -GNinja -DCMAKE_EXPORT_COMPILE_COMMANDS=1 -DCMAKE_BUILD_TYPE=Debug -S . build
+cmake --build build
+```
+
+## Installing the Outlook extension
+
+You can install the certificate by visiting the following address:
+`https://outlook.office365.com/owa/?path=/options/manageapps`. This will load after
+a short while the addon manager and you can upload the manifest in
+`broker/manifest.xml` to the user defined Add-Ins.
+
+## Run it
+
+The application consists of two process, you need to start both of them:
+
+```sh
+./build/bin/gpgol-broker
+```
+
+and in a seperate terminal tab
+
+```sh
+./build/bin/gpgol-server
+```
+
+Outlook requires the connections to be using HTTPS, so you need to trust
+the self signed certificate in your browser, so open
+[https://127.0.0.1:5656/home](https://127.0.0.1:5656/home) and trust the certificate.
+The certificate is also used on port 5657 for the websocket connection, so you
+might need to trust it also on that port.
+
+If you don't want to trust the self signed certificate included in this repo, you
+can also create your own and replace `broker/assets/certificate.crt` and
+`broker/assets/private.key`. You will also need to recompile the app.
+
+In the future, the certificate should be generated by the installer and trusted
+automatically when installing the app.