it should get the TOC from the global _toc.yaml...

admin-guide/deployment.md

@@ -0,0 +1,17 @@
+# Deployment
+
+Linux systems are generally deployed using PXE and Kickstart. We use iPXE, which
+can retrieve its configuration via HTTP(S) and therefore gives us a lot of
+flexibility, because the iPXE configuration can be generated on the fly with the
+specific settings needed by the booting client. In the same way the Kickstart
+configuration for the RHEL installer is auto-generated.
+
+The information used for generating the iPXE and Kickstart configurations is
+stored in the sysdb (see below). The sysdb is accessible through a web api, and
+a command line client is available.
+
+When PXE boot is not an option, e.g. in restricted networks, it is possible to
+start iPXE from a USB stick or other media.
+
+```{tableofcontents}
+```