Open an SSH workspace

Creates a workspace connected to a remote host over SSH.

macos · sign-in required · updated 2026-07-12

Format

cmux://ssh?host={host}&user={user}&port={port}&title={title}

webhttps://cmux.com/deeplink/ssh?host={host}&user={user}&port={port}&title={title}

Try it

cmux://ssh?host=dev.example.com&user=alice&port=2222&title=GPU%20boxOpen

What you supply

{host}

SSH host, or an alias from your ~/.ssh/config.

An alias is usually the better choice — it lets the reader's own config decide how the connection is actually made.

{user}optional

SSH username, joined to the host as user@host.

{port}optional

SSH port, 1–65535.

Defaults to 22.

{title}optional

What to call the workspace.

name works as an alias. Use one or the other, not both.

Prefer the https://cmux.com/deeplink/ssh?… form for a link other people will click: it opens the native scheme when cmux is installed and shows the download page when it is not, where the bare cmux:// link would simply do nothing.

The link is a request, not a command. cmux shows the connection and waits for confirmation.

Also accepted, all optional: connect-timeout (1–600s), server-alive-interval (1–3600s), server-alive-count-max (1–100), host-key-policy (accept-new, ask, strict, yes), and no-focus to build the workspace without switching to it.