Homelab/docs/guides/NAS_Mount_Guide.md

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:

sudo mkdir -p /mnt/nas

Credentials File (optional)

Store credentials in a secure file (e.g., /etc/nas-cred):

username=your_nas_user
password=your_nas_password

Set restrictive permissions:

sudo chmod 600 /etc/nas-cred

Add to /etc/fstab

Append the following line to /etc/fstab on each node:

//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

sudo mount -a

Verify:

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:

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.