Troubleshooting YAMS¶
Start with Quick fixes → Fix everything in the YAMS dashboard. It solves most connection problems.
- qBittorrent says "Waiting for the VPN". Open Logs on the VPN row. The last lines say why the tunnel isn't up (an expired key, an unreachable server). Downloading a fresh WireGuard file for another server fixes most cases.
- An app says "Keeps restarting". Its row shows the last log line; open Logs for the full story.
- VPN says "Can't connect". Download a file for a different server. Some providers' files expire, and a few (e.g. NordVPN) don't offer WireGuard downloads at all; Proton VPN, Mullvad and AirVPN all do.
- Port 8097 is taken. Denny's store has an Emby app on the same port; you can't run both. Otherwise change
8097:8096indocker-compose.ymlandJELLYFIN_PORTon the dashboard service to the same new number. - You changed the qBittorrent password. Update it in Sonarr and Radarr under Settings → Download Clients.
- Logs. Use Logs on any app in the YAMS dashboard. Umbrel's own Troubleshoot view (right-click YAMS) works too. Lines starting with
[yams]come from this package. - Start over. Back up first, then uninstall YAMS (this deletes its settings, not your media or backups in Downloads) and install again. Restore the backup if you want your settings back.
- A restore went wrong. Every restore first saves a "Before restore" backup; restore that one to get back to where you were.
Known limits¶
- VPN setup supports WireGuard files. OpenVPN-only providers aren't covered by the dashboard yet.
- VPN port forwarding isn't configured, so torrents work but may connect to fewer peers.
- Hardware transcoding needs umbrelOS 2.1 or newer, which passes your graphics card (Intel, AMD or NVIDIA) to YAMS. Then pick it in Jellyfin under Dashboard → Playback → Transcoding (VAAPI or QSV for Intel/AMD, NVENC for NVIDIA).
- Only the Downloads folder is used; external drives need Umbrel 2.0's folder access feature or a manual mount.