docs: added basic deploy guide
diff --git a/docs/admin/deploy.md b/docs/admin/deploy.md
new file mode 100644
index 0000000..b94ae57
--- /dev/null
+++ b/docs/admin/deploy.md
@@ -0,0 +1,59 @@
+# Deployment Guide
+
+## Building inventory
+
+In order to deploy Atmosphere, you will need to build a directory structure
+that will contain all the configuration files and secrets required to deploy
+the platform.
+
+The recommended layout is as follows:
+
+```text
+cloud-config
+├── inventory
+│ ├── group_vars
+│ │ ├── all
+│ │ │ ├── ceph.yml
+│ │ │ ├── cluster_issuer.yml
+│ │ │ ├── endpoints.yml
+│ │ │ ├── keepalived.yml
+│ │ │ ├── kube-prometheus-stack.yml
+│ │ │ ├── kubernetes.yml
+│ │ │ ├── neutron.yml
+│ │ │ └── secrets.sops.yml
+│ │ ├── cephs
+│ │ │ └── osds.yml
+│ └── hosts.ini
+├── playbooks
+│ └── site.yml
+└── requirements.yml
+```
+
+### `hosts.ini` file
+
+The `hosts.ini` file is the Ansible inventory file that will be used to deploy
+the platform. It is recommended to use the following layout:
+
+```ini
+[controllers]
+ctl1.cloud.atmosphere.dev
+ctl2.cloud.atmosphere.dev
+ctl3.cloud.atmosphere.dev
+
+[computes]
+kvm1.cloud.atmosphere.dev
+kvm2.cloud.atmosphere.dev
+kvm3.cloud.atmosphere.dev
+
+[cephs]
+ceph1.cloud.atmosphere.dev
+ceph2.cloud.atmosphere.dev
+ceph3.cloud.atmosphere.dev
+```
+
+!!! warning
+
+ The hostnames listed in the inventory file must be a FQDN that resolves to
+ the IP address of the host. If they do not, you will have failures such
+ as agents failing to start, live migration failures and other transient
+ and hard to diagnose issues.