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

ItemValue
Remotesparks@plex:/raid
Local mount/nas
MechanismSSHFS in a user-systemd service
LifecycleEnabled in default.target; starts with the user manager and restarts after failures
KeepaliveReconnect; 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

  1. Install SSHFS: omarchy pkg add sshfs.
  2. Create /nas and make it writable by the login user:
sudo install -d -o "$USER" -g "$USER" /nas
  1. Verify non-interactive access before installing the unit:
ssh -F /dev/null sparks@plex true
  1. 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