diff --git a/README.md b/README.md
index 875aaee..ac4522c 100644
--- a/README.md
+++ b/README.md
@@ -8,3 +8,56 @@
 
 # greenlock-challenge-s3
 S3 backed challenge strategy for greenlock-express.js (and greenlock.js)
+
+## Requirements
+
+You will need a s3 bucket and the corresponding credentials.
+
+## Integration
+
+### greenlock-express.js
+
+```javascript
+
+let challenge = require('greenlock-challenge-s3').create({
+    accessKeyId: accessKeyId                // Replace with your accessKeyId
+    , secretAccessKey: secretAccessKey      // Replace with your secretAccessKey
+    , regionName: regionName                // Replace with your regionName
+    , bucketName: bucketName                // Replace with your bucketName
+    , directory: ''                         // Recommended
+    , debug: true                           // Debug
+});
+
+var Greenlock = require("greenlock-express");
+
+var greenlock = Greenlock.create({
+    // Other options
+    , challenge: challenge
+});
+
+// Continue your greenlock setup
+
+```
+
+## Testing
+
+The strategy is tested against the greenlock-store-test [https://git.coolaj86.com/coolaj86/greenlock-challenge-test.js]
+
+To run the tests yourself, create a `.env` file with the following
+
+```
+// .env file
+AWS_ACCESS_KEY_ID=abc           // Replace with your accessKeyId
+AWS_SECRET_ACCESS_KEY=abc       // Replace with your secretAccessKey
+AWS_BUCKET_REGION=abc           // Replace with your regionName
+AWS_BUCKET_NAME=abc             // Replace with your bucketName
+```
+
+Run the following command: 
+```console
+$ npm run clean && npm run test && npm run clean
+```
+
+## License
+
+ISC