Hermes Agent + Tailscale: remote gateway setup

Learn to access one Hermes backend from multiple devices with Tailscale, dashboard authentication and a shared macOS workspace.

Player not loading? Watch on YouTube

This tutorial connects a laptop to a Hermes Agent backend running on a desktop through Tailscale. It assumes Hermes is already installed. The speaker demonstrates the setup on a Mac Studio and MacBook Pro, with the desktop holding the sessions and memory while the laptop acts as a client. The demonstrated connection uses a cloud GPT model; local inference is an optional configuration on the desktop.

The walkthrough covers adding both computers to the same tailnet, configuring dashboard credentials and starting the dashboard with host 0.0.0.0. The browser connects through the desktop's Tailscale address. The speaker gives port 9119 for browser access but later says 9199 during desktop app configuration, so the instructions contain a port discrepancy.

The browser dashboard supports profile switching. For the native desktop app's remote gateway, the speaker recommends the laptop's default profile because a reported issue with other profiles can prevent session history from connecting after a restart.

File access needs a separate setup. The demonstration enables macOS folder sharing and mounts the workspace through SMB using a Tailscale MagicDNS hostname. For a Docker backend, files need to reach a mounted workspace. If the remote backend stops, a local fallback is a separate instance: it does not automatically inherit the desktop's history or memories.