# Mounting Calypso NAS on Concord NUC

This guide covers mounting the Calypso NAS media share on the NUC for Plex access.

## Prerequisites

1. Verify Tailscale connectivity:
   ```bash
   ping 100.103.48.78  # Calypso's Tailscale IP
   ```

2. Install CIFS utilities:
   ```bash
   sudo apt install cifs-utils -y
   ```

## Setup

### 1. Create Mount Point

```bash
sudo mkdir -p /mnt/nas
```

### 2. Create Credentials File (Secure)

```bash
sudo nano /root/.smbcredentials
```

Add:
```
username=Vish
password=REDACTED_PASSWORD
```

Secure the file:
```bash
sudo chmod 600 /root/.smbcredentials
```

### 3. Add to /etc/fstab (Persistent Mount)

```bash
sudo nano /etc/fstab
```

Add this line:
```
//100.103.48.78/data/media /mnt/nas cifs credentials=/root/.smbcredentials,vers=3.0,uid=1000,gid=1000,file_mode=0755,dir_mode=0755,_netdev,x-systemd.automount 0 0
```

### 4. Mount

```bash
sudo mount -a
```

### 5. Verify

```bash
ls -la /mnt/nas
# Should show: movies, tv, music, etc.
```

## Troubleshooting

### Mount fails on boot
The `_netdev` and `x-systemd.automount` options ensure the mount waits for network.
If issues persist, check that Tailscale starts before mount:

```bash
sudo systemctl status tailscaled
```

### Permission issues
Ensure `uid=1000,gid=1000` matches the user running Plex/Docker.

### Slow performance
See [Network Performance Tuning](docs/infrastructure/network-performance-tuning.md) for SMB optimization.

## Performance Notes

- **SMB over Tailscale**: ~139 MB/s (1.1 Gbps) - sufficient for 4K streaming
- **Direct LAN access**: Best for 4K remux playback
- **NFS alternative**: Not recommended over Tailscale (slower than SMB in testing)
