diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1bfb130
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+# Hass.io Plejd add-on
+Hass.io add-on for Plejd home automation devices. Gives you the ability to control the Swedish Plejd home automation devices through Home Assistant.
+It uses MQTT to communicate with Home Assistant and supports auto discovery of the devices in range.
+
+Thanks to [ha-plejd](https://github.com/klali/ha-plejd) for inspiration.
+
+## Getting started
+To get started, make sure that the following requirements are met:
+
+### Requirements
+* A Bluetooth device (BLE), for eg. the built-in device in Raspberry Pi 4.
+* An MQTT broker (the Mosquitto Hass.io add-on works perfectly well).
+
+### Tested on
+The add-on has been tested on the following platforms:
+* Mac OS Catalina 10.15.1 with Node v. 13.2.0
+* Raspberry Pi 4 with Hass.io
+
+### Installation
+Browse your Hass.io installation using a tool that allows you to manage files, for eg. SMB or an SFTP client etc.
+* Open the `/addon` directory
+* Create a new folder named `hassio-plejd`
+* Copy all files from this repository into that newly created one.
+* Open the Home Assistant web console and click `Hass.io` in the menu on the left side.
+* Click on `Add-on Store` in the top navigation bar of that page.
+* Click on the refresh button in the upper right corner.
+* A new Local Add-on should appear named Plejd. Open that and install.
+
+### Configuration
+The plugin needs you to configure some settings before working.
+
+Parameter | Value
+--- | ---
+site | Name of your Plejd site, the name is displayed in the Plejd app (top bar).
+username | Username of your Plejd account, this is used to fetch the crypto key and devices from the Plejd API.
+password | Password of your Plejd account, this is used to fetch the crypto key and devices from the Plejd API.
+mqttBroker | URL of the MQTT Broker, eg. mqtt://localhost
+mqttUsername | Username of the MQTT broker
+mqttPassword | Password of the MQTT broker
+
+## License
+
+```
+Copyright 2019 Marcus Westin <marcus@sekurbit.se>
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+```