# 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.*