Initial commit: homelab configuration and documentation

docs/guides/NAS_Mount_Guide.md

@@ -0,0 +1,62 @@
+# NAS Mount Guide
+
+This guide explains how to mount the dedicated NAS shares on all homelab nodes.
+
+## Prerequisites
+- NAS is reachable at `\192.168.1.200` (replace with your NAS IP).
+- You have a user account on the NAS with read/write permissions.
+- `cifs-utils` is installed on each node (`sudo apt-get install cifs-utils`).
+
+## Mount Point
+Create a common mount point on each node:
+```bash
+sudo mkdir -p /mnt/nas
+```
+
+## Credentials File (optional)
+Store credentials in a secure file (e.g., `/etc/nas-cred`):
+```text
+username=your_nas_user
+password=your_nas_password
+```
+Set restrictive permissions:
+```bash
+sudo chmod 600 /etc/nas-cred
+```
+
+## Add to `/etc/fstab`
+Append the following line to `/etc/fstab` on each node:
+```text
+//192.168.1.200/shared    /mnt/nas    cifs    credentials=/etc/nas-cred,iocharset=utf8,vers=3.0    0    0
+```
+Replace `shared` with the actual share name.
+
+## Mount Immediately
+```bash
+sudo mount -a
+```
+Verify:
+```bash
+df -h | grep /mnt/nas
+```
+You should see the NAS share listed.
+
+## Docker Volume Example
+When deploying services that need persistent storage, reference the NAS mount:
+```yaml
+volumes:
+  nas-data:
+    driver: local
+    driver_opts:
+      type: none
+      o: bind
+      device: /mnt/nas/your-service-data
+```
+
+## Troubleshooting
+- **Permission denied** – ensure the NAS user has the correct permissions and the credentials file is correct.
+- **Mount fails** – try specifying a different SMB version (`vers=2.1` or `vers=3.1.1`).
+- **Network issues** – verify the node can ping the NAS IP.
+
+---
+*This guide can be referenced from the updated `Homelab.md` documentation.*