diff --git a/docs/install.md b/docs/install.md
new file mode 100644
index 0000000..2082708
--- /dev/null
+++ b/docs/install.md
@@ -0,0 +1,149 @@
+# Installation
+
+## Requirements
+
+GNU/Linux  [debian](https://debian.org) based distribution able to run docker-compose v1.28 or newer.
+
+## Configuration
+
+It's a good idea to familiarize with the settings available in [`dd.conf.sample`][dd.conf.sample], which is the main configuration file.
+
+[dd.conf.sample]: https://gitlab.com/DD-workspace/DD/-/blob/main/dd.conf.sample
+
+The installation process must be done using `dd-install.sh`, answering the questions and/or passing environment variables, it will write a dd.conf based on the dd.conf.sample. As example:
+
+```
+> DD_NETWORK_MTU=1450 ./dd-install.sh
+```
+## Guided install
+
+Using the script [`dd-install.sh`][dd-install.sh] without any arguments will proceed with the guided installation.
+
+[dd-install.sh]: https://dd-work.space/docs/dd-install.sh
+
+The wizard will guide you through the installation process. it will ask you a sequence of questions, to install and configure for the first time.
+
+Once installation is complete, you can proceed with the [post-installation](post-install.md).
+
+### Guided example
+
+```bash
+# We obtain dd-install.sh
+> wget https://dd-work.space/docs/dd-install.sh -O dd-install.sh
+# Make it executable
+> chmod +x dd-install.sh
+# And run it
+> ./dd-install.sh
+Interactive install detected!
+Please follow the instructions carefully:
+
+Under which DOMAIN will you install DD? example.org
+
+
+You will need to setup DNS entries for:
+- [ ] moodle.dd.004.es
+- [ ] nextcloud.dd.004.es
+- [ ] wp.dd.004.es
+- [ ] oof.dd.004.es
+- [ ] sso.dd.004.es
+- [ ] pad.dd.004.es
+- [ ] admin.dd.004.es
+- [ ] api.dd.004.es
+- [ ] correu.dd.004.es
+
+
+What is the short title of the DD instance? [DD]
+What is the full title of the DD instance? [DD] DD at example.org
+Do you want to use Let's Encrypt certificates? [Y/n] Y
+Which email will you use for Let's Encrypt notifications? letsencrypt@example.org
+Generate a certificate for example.org? (neds the DNS entry) [y/N] N
+Path to the logo's PNG file (optional):
+Path to the background's PNG file (optional):
+About to install with following information:
+
+DOMAIN=example.org
+TITLE_SHORT=DD
+TITLE=DD at example.org
+LETSENCRYPT_DNS=example.org
+LETSENCRYPT_EMAIL=letsencrypt@example.org
+LETSENCRYPT_DOMAIN_ROOT=false
+
+Custom logo in PNG (if requested):
+Custom background in PNG (if requested):
+Is this correct? proceed with the install? [Y/n] Y
+```
+<details><summary>Logos</summary>
+Optionally you can define the logos by placing the <code>.png</code> files on the server and indicate their path when the installer requests them.
+</details>
+
+<details><summary>Pre-existing certificate</summary>
+You can use your own certificate, being it a single, wildcard or SAN certificate. You can read more in the [wildcard](wildcard.md) section.
+</details>
+
+## Unattended install
+
+The installer accepts all the variables existing in [`dd.conf.sample`][dd.conf.sample] as environment variables using the `DD_` prefix to distinct of other environment variables.
+
+For example, the variable `DOMAIN` can be pre-configured with the environment variable `DD_DOMAIN`.
+Read the next example.
+
+If `DD_DOMAIN` is defined, the unattended installation will be started using values from environment variables.
+Otherwise, without defining `DD_DOMAIN`, it will proceed with the unattended installation.
+
+Take note that when using the unattended mode, the dns records must resolve to your server ip address. You will need to setup DNS records for:
+
+	- moodle.${DD_DOMAIN}
+    - nextcloud.${DD_DOMAIN}
+    - wp.${DD_DOMAIN}
+    - oof.${DD_DOMAIN}
+    - sso.${DD_DOMAIN}
+    - pad.${DD_DOMAIN}
+    - admin.${DD_DOMAIN}
+    - api.${DD_DOMAIN} 
+
+> It is worth noting that this way of installation can be automated with provisioning tools such as [Ansible][ansible], [cdist][cdist] or [Puppet][puppet].
+
+[ansible]: https://ansible.com
+[cdist]: https://cdi.st
+[puppet]: https://puppet.com
+
+Once installation is complete, you can proceed with the [post-installation](post-install.md).
+
+### Unattended example
+
+```bash
+> export DD_DOMAIN="example.org"
+> export DD_TITLE="DD at example.org"
+> export DD_TITLE_SHORT="DD"
+> export DD_LETSENCRYPT_DNS="example.org"
+> export DD_LETSENCRYPT_EMAIL="letsencrypt@example.org"
+#
+#
+# We obtain dd-install.sh
+> wget https://dd-work.space/docs/dd-install.sh -O dd-install.sh
+# Make it executable
+> chmod +x dd-install.sh
+# And run it
+> ./dd-install.sh
+```
+
+<details><summary>Logos</summary>
+Optionally you can define the logos by placing the <code>.png</code> files on the server and pointing the environment variables <code>DDIMG_LOGO_PNG</code> and
+<code>DDIMG_BACKGROUND_PNG</code> to their path.
+</details>
+
+## Manual install
+
+The manual install is documented in file [`dd-install.sh`][repo-dd-install.sh] from line :
+
+[repo-dd-install.sh]: https://gitlab.com/DD-workspace/DD/-/blob/main/dd-install.sh
+
+```bash
+#
+# START MANUAL INSTALL
+#
+```
+
+You will find comments for each step along with their respective commands.
+
+Once installation is complete, you can proceed with the [post-installation](post-install.md).