Storage
Plex & RAID
Plex’s remote /raid is mounted over SSHFS at local /nas. The user service is enabled and active as verified on 2026-09-08.
Overview
| Item | Value |
|---|---|
| Remote | sparks@plex:/raid |
| Local mount | /nas |
| Mechanism | SSHFS in a user-systemd service |
| Lifecycle | Enabled in default.target; starts with the user manager and restarts after failures |
| Keepalive | Reconnect; SSH keepalive every 15 seconds, failing after 3 missed replies |
This is a user mount, not a system fstab mount. It comes up when the user systemd manager starts (normally at desktop login); the unit alone does not make it available before login.
User service
~/.config/systemd/user/plex-raid.service
[Unit]
Description=Mount Plex /raid at /nas over SSHFS
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=/usr/bin/sshfs -f -o reconnect -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ssh_command=/usr/bin/ssh\x20-F\x20/dev/null sparks@plex:/raid /nas
ExecStop=/usr/bin/fusermount3 -u /nas
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.target
-f keeps SSHFS in the foreground so systemd supervises it. The explicit SSH command ignores personal SSH config; the hostname plex must resolve and key-based access for sparks must work without an interactive prompt.
Manage & check
# Status and logs
systemctl --user status plex-raid
journalctl --user -u plex-raid -b
# Manual lifecycle
systemctl --user restart plex-raid
systemctl --user stop plex-raid
systemctl --user start plex-raid
# Confirm the mount is usable
findmnt /nas
ls /nas
Stop the service before manually unmounting. If the remote host is briefly unavailable, leave the unit running: Restart=on-failure retries after five seconds.
Recreate
- Install SSHFS:
omarchy pkg add sshfs. - Create
/nasand make it writable by the login user:
sudo install -d -o "$USER" -g "$USER" /nas
- Verify non-interactive access before installing the unit:
ssh -F /dev/null sparks@plex true
- Restore the unit above, then load and enable it:
systemctl --user daemon-reload
systemctl --user enable --now plex-raid
findmnt /nas
Do not put a private key or password in the unit. Restore the SSH key and the remote account’s authorized_keys separately.
File index
~/.config/systemd/user/plex-raid.service
~/.config/systemd/user/default.target.wants/plex-raid.service # enabled symlink
/nas # local mount point