Muxie Get Muxie
How-to guides How-to guide

Connect to an SSH host

Open an SSH session, save a connection with credentials in your OS secret store, and let it reconnect automatically after a drop.

Muxie can open a shell on a remote machine over SSH, save it for next time, and bring it back automatically after a brief network drop.

Open an SSH session

The SSH plugin adds an SSH… entry to the + New menu (the titlebar button, or the + on a pane). Choosing it opens a host picker with quick search, your recent hosts, and hosts discovered from your SSH config.

Note: If you don’t see the SSH… entry, enable the SSH plugin under Settings → Plugins. The Sprites plugin is enabled the same way.

Pick a host and Muxie opens a remote shell in a new pane. See Session types for how this differs from a local terminal.

Save a connection

You can save connections in the connection manager, a dockable panel. Saved credentials are stored through your operating system’s secret store:

  • macOS — Keychain
  • Windows — DPAPI
  • Linux — libsecret or KWallet

You can choose a key per connection, so different hosts can authenticate with different keys.

Tip: When a host asks for a password, Muxie prompts you with an in-pane banner. Type the password there and the session continues.

Reconnect after a drop

SSH sessions are durable. The remote shell keeps running on the host, so a network blip doesn’t kill your work — Muxie reconnects automatically and reattaches you to the same session. See Durable sessions for the full picture.

The sshForwardOpens setting (on by default) installs a small browser-open forwarder on the remote host. With it in place, a remote open or xdg-open call opens the link on your local machine instead of failing on a headless server.

Heads up: This is a POSIX-style integration. On hosts that don’t support it, it simply does nothing and the rest of the session works normally.

To preview a service running on the remote host, see Forward a port.