diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2a1feb0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,67 @@
+# Minecraft Discord Bridge
+Required Python version: 3.6 or later.
+
+Docker support: yes, recommended.
+
+## Installation instructions
+1. Clone the repository
+2. Edit the config.json file to your liking, an example is provided in `config.example.json`
+
+     ```
+    mv config.example.json config.json
+    vi config.json
+     ```
+3. If you are using an sqlite database (like the default one in the config, create it now)
+ 
+    ```
+    touch db.sqlite
+    ```
+
+4. Run the bridge!
+    1. If you are not using docker, just install the dependencies and start the bot.
+        ```
+        python -m pipenv --three
+        python -m pipenv install
+        python -m pipenv run ./webhook-bridge.py
+        ```
+    2. If you are using docker, just use the included `docker-compose.yml` to get up and running
+        ```
+        docker-compose up -d
+        ```
+        
+ 5. If this is the first time you run this bridge, you need to invite it to your discord guild with the following link:
+ 
+     **Note:** Make sure to replace the "<CLIENT_ID>" in the link below with your bot's client ID
+     
+     `https://discordapp.com/oauth2/authorize?client_id=<CLIENT_ID>&scope=bot&permissions=536879104`
+     
+     Once it has joined your server, create a text channel for it to post in, then press the "Edit Channel" button on that channel. From there, press the "Permissions" button and click the "+" button and add "Minecraft Chat Bridge" to the room and close the permissions window.
+     
+     Now that permissions are set, all you need to do is to do is to type "mc!chathere" and the bridge will take over if it is running.
+     
+ 
+ 
+## Configuration
+All of the configuration data is stored in a file called `config.json` that must be stored in the same directory as the executable
+
+#### Json keys
+|Key                        |Default value              |Explanation|
+|:--------------------------|:--------------------------|:----------|
+|MAIN.MC_USERNAME           |""                         |The username or e-mail address of the bot's minecraft account
+|MAIN.MC_PASSWORD           |""                         |The password of the bot's minecraft account
+|MAIN.MC_SERVER             |""                         |The IPv4 address of the minecraft server to connect to
+|MAIN.MC_PORT               |25565                      |The port of the minecraft server to connect to
+|MAIN.MC_ONLINE             |true                       |Whether or not to authenticate the bot's minecraft account with Mojang's authentications server
+|MAIN.DISCORD_APP_TOKEN     |""                         |The discord bot token the birdge will use to log into discord
+|MAIN.LOG_LEVEL             |"INFO"                     |Set the log level, can be `INFO` or `DEBUG`
+|MAIN.MESSAGE_DELAY         |1.5                        |Set the delay between messages sent from discord to minecraft
+|MAIN.ADMINS                |\[283983554051047425\]     |Array of discord user ids that have administrative access to the bot
+|AUTH_SERVER.BIND.IP        |""                         |The IPv4 address which the authentication server will bind to (set to blank for 0.0.0.0)
+|AUTH_SERVER.PORT           |9822                       |The port which the authentication server will bind to
+|AUTH_SERVER.DNS_WILDCARD   |""                         |Must be set to a wildcard DNS `CNAME` record that points to and `A` record pointing to the authentication server's IP address
+|DATABASE.CONNECTION_STRING |"sqlite:////data/db.sqlite"|Must be set to any valid `SQLAlchemy` connection string. Defaults to an empty sqlit database in `/data` for docker user
+|ELASTICSEARCH.ENABLED      |false                      |Whether or not to enable elasticsearch analytics collection
+|ELASTICSEARCH.URL          |""                         |Fully qualified URL to the elasticsearch server
+|ELASTICSEARCH.AUTH         |false                      |Whether or not the elasticsearch http endpoint is protected by HTTP Basic authentication
+|ELASTICSEARCH.USERNAME     |""                         |HTTP Basic authentication username for elasticsearch
+|ELASTICSEARCH.PASSWORD     |""                         |HTTP Basic authentication password for elasticsearch
\ No newline at end of file