Sanitized mirror from private repository - 2026-04-20 01:24:42 UTC

docs/infrastructure/mounting-calypso-on-nuc.md

@@ -0,0 +1,86 @@
+# 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)