63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
# 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.*
|