Distribution docs

README.md

@@ -7,6 +7,36 @@ Register [Marathon](https://mesosphere.github.io/marathon/) Tasks as [Consul](ht
 forwards it to Consul agents. It also re-syncs all the information from Marathon 
 to Consul on startup and repeats it with given interval.
 
+## Installation
+
+Binary distribution of `marathon-consul` can be downloaded directly from [GitHub Releases page](https://github.com/allegro/marathon-consul/releases).
+
+### Installing via APT
+
+If you are a Debian/Ubuntu user, you can easily install `marathon-consul` as a `.deb` package using `APT` package manager. Both `upstart` and `systemd` service managers are supported.
+All releases are published as `.deb` packages to [our repository at Bintray](https://bintray.com/allegro/deb/marathon-consul/view).
+
+To install `marathon-consul` with `apt-get`, simply follow the instructions:
+
+```bash
+# add our public key to apt
+curl -s https://bintray.com/user/downloadSubjectPublicKey?username=allegro | sudo apt-key add -
+# add the repository url
+echo "deb http://dl.bintray.com/v1/content/allegro/deb /" | sudo tee /etc/apt/sources.list.d/marathon-consul.list
+# update apt cache
+sudo apt-get -y update
+# install latest release of marathon-consul
+sydo apt-get -qy install marathon-consul
+```
+
+Installed `marathon-consul` binary can be then run as:
+
+```bash
+service marathon-consul start
+```
+
+The configuration file is located at `/etc/marathon-consul.d/config.json`.
+
 ## Running the program
 
 Just run `marathon-consul`.