From 2c910f86166516f453e1c0a60693da15e1539f47 Mon Sep 17 00:00:00 2001
From: Johannes Kirschbauer <hsjobeki@gmail.com>
Date: Sat, 12 Jul 2025 16:15:17 +0200
Subject: [PATCH] docs: add guide how to create configuration.nix

---
 docs/site/guides/getting-started/add-machines.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/site/guides/getting-started/add-machines.md b/docs/site/guides/getting-started/add-machines.md
index b6d2bb834..f5c3732fd 100644
--- a/docs/site/guides/getting-started/add-machines.md
+++ b/docs/site/guides/getting-started/add-machines.md
@@ -82,6 +82,21 @@ This example demonstrates what is needed based on a machine called `jon`:
 2. Add your *ssh key* here - That will ensure you can always login to your machine via *ssh* in case something goes wrong.
 3. Tags can be used to automatically add this machine to services later on. - You dont need to set this now.
 
+### (Optional) Create a `configuration.nix`
+
+```nix title="./machines/jon/configuration.nix"
+{
+    imports = [
+        # enables GNOME desktop (optional)
+        ../../modules/gnome.nix
+    ];
+
+    # Set nixosOptions here
+    # Or import your own modules via 'imports'
+    # ...
+}
+```
+
 ### (Optional) Renaming a Machine
 
 Older templates included static machine folders like `jon` and `sara`.