diff --git a/README.md b/README.md
index 0339e4c..e9c1561 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,99 @@
 # Push tagged wallabag articles to kindle
 
-**This project is Work in progress!**
 
-This is a service that polls a [Wallabag](https://wallabag.org/en) instance for
-articles with a certain tag (`kindle`, `kindle-mobi` or `kindle-pdf`). If it
-finds an article tagged with one of thse tags, it exports the article in the
-requested format and sends it via email to a configured kindle adress.
+This is a service that polls a [Wallabag](https://wallabag.org/en)
+instance for articles with a certain tag (`kindle`, `kindle-mobi` or
+`kindle-pdf`). If it finds an article tagged with one of thse tags, it
+exports the article in the requested format and sends it via email to a
+configured kindle adress.
+
+The software consists of three parts:
+
+* **consumer:** This is the part that consumes the tags from wallabag
+  and pushes them to the kindle addresses.
+* **refresher:** As wallabag gives no permanent api tokens we need to
+  refresh them regularly. This part asks for a new token every time the
+  old one is due to expire. With this method we don't need to save the
+  users password. If we miss a refresh cycle (for example because the
+  service was stopped) it will send the user an email to its notification
+  address asking him to log in again to get a fresh token.
+* **interface:** This provides a basic web interface to register new
+  users, refresh logins or delete users.
+
+All parts can run in one process or you can use seperate processes for
+each part. All they share is the configuration and the database.
+
+## Configuration
+
+The configuration can be done either by a ini-format configuration file
+or via environment variables. The later is used for running the service
+via docker. All config option have ro be below a section called `DEFAULT`.
+You can just copy and modify the example config.
+
+The following tabe describes all options:
+
+| file-option       | env-var            | type     | default    | description |
+|-------------------|--------------------|----------|------------|----------|
+|`wallabag_host`    | `WALLABAG_HOST`    | required |            | The http url of the wallabag host. |
+|`db_uri`           | `DB_URI`           | required |            | The dbapi url for the database. |
+|`client_id`        | `CLIENT_ID`        | required |            | The Wallabag client id. Read [here](https://doc.wallabag.org/en/developer/api/oauth.html) how to get it.  |
+|`client_secret`    | `CLIENT_SECRET`    | required |            | The Wallabag client secret. Read above. |
+|`domain`           | `DOMAIN`           | required |            | the domain the interface for the service is accessible on. |
+|`smtp_from`        | `SMTP_FROM`        | required |            | The from-address to use. |
+|`smtp_host`        | `SMTP_HOST`        | required |            | The SMTP hostname or ip. |
+|`smtp_port`        | `SMTP_PORT`        | required |            | The Port of the SMTP server. |
+|`smtp_user`        | `SMTP_USER`        | required |            | The user for SMTP auth. |
+|`smtp_passwd`      | `SMTP_PASSWD`      | required |            | The password for SMTP auth. |
+|`tag`              | `TAG`              | optional | `kindle`   | The tag to consume. |
+|`refresh_grace`    | `REFRESH_GRACE`    | optional | `120`      | The amount of seconds the token is refreshed before expiring. |
+|`consume_interval` | `CONSUME_INTERVAL` | optional | `30`       | The time in seconds between two consume cycles. |
+|`interface_host`   | `INTERFACE_HOST`   | optional | `120.0.0.1`| The IP the user interface should bind to.  |
+|`interface_port`   | `INTERFACE_PORT`   | optional | `8080`     | The port the user interface should bind. |
+
+The config file is read either from the current working dicectory where it
+would be called `config.ini` or from a path hiven to the commandline option
+`--cfg`. To use configuration via environment use `--env`.
+
+
+## Running
+
+Every component must be enabled via a commandline switch. To runn all three
+in one prcess use all three:
+```
+$ ./service.py --refresher --consumer --interface
+```
+
+For more information about commandline options use `--help`.
+
+
+## Database
+
+The servie uses a database. The easiest option is to use sqlite. To save
+all data in a file called database.db in the current working directory set
+`sqlite:///database.db` in the config option `db_uri` or the env variable
+`DB_URI`.
+
+To initialize the database, run the server once with `--create_db`.
+
+
+## Docker
+
+The provided dockerfile makes it easy to use the software as a docker
+container. The latest state of the master branch can be found as a 
+[Automated build on the Docker hub](https://hub.docker.com/r/janlo/feedbin-refresher/).
+
+You can easily configure the container via the environment variables from
+above. Just make sure, that the datavase is in a volume if you use sqlite.
+
+
+## Usage
+
+As soon as you've set it all up you can reister your wallabag user in the
+Web-UI. The service does not store any login information other than the
+user name and the API token for wallabag. All actions that need a valid
+user like register/login/delete a user are authenticated directly against
+the wallabag server.
+
+## License
+
+MIT