diff --git a/deployments/README.md b/deployments/README.md
new file mode 100644
index 0000000..ae54a0d
--- /dev/null
+++ b/deployments/README.md
@@ -0,0 +1,39 @@
+# Kerberos Agent Deployments
+
+Great to see you here, you just arrived at the real stuff! As you may have understood Kerberos Agent is a containerized solution. A Kerberos Agent, or container equivalent, is running for each camera. This approach makes it scalable, isolated and probably the most important thing an exceptional workload governance.
+
+Due to it's nature, of acting as a micro service, there are many different ways how to get this Kerberos Agent up and running. This part of the Kerberos Agent repository contains example configurations, for all the different deployments and automations you can leverage to deploy and scale your video landscape.
+
+We will discuss following deployment models.
+
+- [Kerberos Agent Deployments](#kerberos-agent-deployments)
+  - [1. Docker](#1-docker)
+  - [2. Docker Compose](#2-docker-compose)
+  - [3. Kubernetes](#3-kubernetes)
+  - [4. RedHat Ansible and OpenShift](#4-redhat-ansible-and-openshift)
+  - [5. Terraform](#5-terraform)
+  - [6. Salt](#6-salt)
+
+## 1. Docker
+
+To be written
+
+## 2. Docker Compose
+
+To be written
+
+## 3. Kubernetes
+
+To be written
+
+## 4. RedHat Ansible and OpenShift
+
+To be written
+
+## 5. Terraform
+
+To be written
+
+## 6. Salt
+
+To be written
\ No newline at end of file
diff --git a/examples/ansible-openshift/README.md b/deployments/ansible-openshift/README.md
similarity index 100%
rename from examples/ansible-openshift/README.md
rename to deployments/ansible-openshift/README.md
diff --git a/examples/ansible-openshift/playbook.yml b/deployments/ansible-openshift/playbook.yml
similarity index 100%
rename from examples/ansible-openshift/playbook.yml
rename to deployments/ansible-openshift/playbook.yml
diff --git a/machinery/data/recordings/.empty b/deployments/docker/README.md
similarity index 100%
rename from machinery/data/recordings/.empty
rename to deployments/docker/README.md
diff --git a/examples/k8s/deployment-agent.yml b/deployments/kubernetes/deployment-agent-volume.yml
similarity index 100%
rename from examples/k8s/deployment-agent.yml
rename to deployments/kubernetes/deployment-agent-volume.yml