diff --git a/README.md b/README.md
index 69a3abc..192b799 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,60 @@
-# ocelot-graceful-load-balancer
+# Ocelot Graceful Load Balancer
+[![nuget](https://img.shields.io/nuget/v/Ocelot.GracefulLoadBalancer)](https://www.nuget.org/packages/Ocelot.GracefulLoadBalancer/)
+## What is it?
+
 A Provider for Ocelot which provides a Round Robin Loadbalancer API Nodes Health Checking.
+
+## Status
+
+The provider is in alpha stage but should be usable. It hase been tested as part of my cluster setup.
+
+This project is open to pull requests.
+
+## Setup
+
+The setup is comparable to other Ocelot providers. Its target framework is netcoreapp3.1.
+
+### Install nuget package
+
+```
+dotnet add package Ocelot.GracefulLoadBalancer --version 0.0.1-alpha
+```
+or visit the nuget for other options on: https://www.nuget.org/packages/Ocelot.GraceFulLoadBalancer
+
+### Adding the provider to your project
+
+The following shows my configuration on the cluster for a 3 Node API Endpoint setup on the balancer 
+and should be easily adaptable to your own settings. I assume you already have basic knowledge of Ocelot.
+Note! That I am using the YAML Configuration provider from NetEscapedes in the sample project instead of
+configuring via JSON. If you prefer JSON it should be easy to convert it manually or with a YAML to JSON converter.
+
+Consider the following configuration:
+
+```YAML
+Routes:
+- DownstreamPathTemplate: "/api/{everything}"
+  DownstreamScheme: http
+  DownstreamHostAndPorts:
+  - Host: 192.168.178.88
+    Port: 8800
+  - Host: 192.168.178.90
+    Port: 8800
+  - Host: 192.168.178.91
+    Port: 8800
+  LoadBalancerOptions:
+    Type: GracefulLoadBalancer
+  UpstreamPathTemplate: "/brp/landen/{everything}"
+  UpstreamHttpMethod:
+  - Get
+```
+
+The `LoadBalancer` options simply point to the implementation. You can add the loadbalancer as follows:
+
+```csharp
+builder.ConfigureServices(s => {
+    s.AddOcelot().AddGracefullLoadBalancer();
+})
+```
+
+View the sample ApiGateway for starting up an entire gateway.
+