diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ffedac5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# Description
+
+This repo defines Nimbus cluster infractructure.
+
+# Requirements
+
+In order to use this you will need secrets(passwords, certs, keys) contained within the [infra-pass](https://github.com/status-im/infra-pass) repository. If you can't see it ask jakub@status.im to get you access for it.
+
+In order for this to work first you need to install necessary Terraform plugins and get the right secrets from the [infra-pass](https://github.com/status-im/infra-pass) repo, to do that simply run:
+```
+make
+# alternatively
+make plugins
+make secrets
+```
+This will put the necessary certificates, keys, and passwords are in place so you can deploy and configure hosts.
+
+# Usage
+
+To deploy hosts for the subsystem run:
+```
+terraform plan
+terraform apply
+```
+Then configure the cluster:
+```
+ansible-playbook ansible/main.yml
+```
+
+__For more details see `README.md` files in `ansible` folders.__
+
+# Details
+
+Read the [Terraform and Ansible](https://github.com/status-im/infra-docs/blob/master/articles/ansible_terraform.md) article in our `infra-docs` repo.