diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index 0f5785729..5a85a03bc 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -82,6 +82,7 @@ nav:
           - reference/clan-core/sops.md
           - reference/clan-core/state.md
   - Contributing: contributing/contributing.md
+  - FAQ: faq/index.md
 
 docs_dir: site
 site_dir: out
diff --git a/docs/site/faq/index.md b/docs/site/faq/index.md
new file mode 100644
index 000000000..5e4a818af
--- /dev/null
+++ b/docs/site/faq/index.md
@@ -0,0 +1,15 @@
+# FAQ
+
+??? Question "Why is targetHost necessary?"
+
+    When using `clan machines install [machine ][targetHost]`
+
+    Why is targetHost necessary if you already configured target host in the configuration?
+
+??? Question "How to check if the correct installation medium?"
+
+    How to warn and check if it is the only installation medium?
+
+??? Question "How are submodules handled in/with clan?"
+
+    How are submodules handled in/with clan?