Adding & editing hosts¶

The host editor writes plain OpenSSH. Every field it exposes becomes part of a Host block in the configuration file. The attributes Muxus adds on top (display name, folder, colour, highlighting, logging policy) are stored in its own database.

Open the editor with + at the top of the sidebar, from a host's Edit host menu entry, or by pressing Enter on a search that matched nothing.

The host editor, General section — The editor has seven sections, and the footer names the file it writes to.

What a save rewrites

Saving rewrites only that block. Comments, ordering, Match blocks and every other host in the file are left untouched. The write is atomic, and the previous contents are kept next to it as <file>.muxus.bak.

General¶

Field	Writes
Alias	The `Host` line. Several aliases separated by spaces are accepted; the first one names the session.
HostName	`HostName`. Empty means the alias is used as the hostname, as in OpenSSH.
Port	`Port`, omitted when it is 22.
User	`User`, omitted to use the local username.
Description	A `#` comment above the block, shown in the sidebar's hover card.
Config file	Which file the block lands in: the main config, an existing `Include`d file, or a new group file that Muxus creates and includes.
Display name, folder, colour	Muxus's own database, not the configuration file.

Authentication¶

Three modes, matching OpenSSH behaviour:

Agent & default keys uses the OpenSSH order: agent first, then ~/.ssh/id_*. Writes nothing, since this is the default.
Specific key file writes IdentityFile. The picker lists the keys found in ~/.ssh with their type and comment, badges the ones loaded in the agent, and marks the ones that are passphrase-protected.
Password / interactive writes PubkeyAuthentication no, so public keys are skipped and a prompt is issued on connect.

User certificates can be added separately as CertificateFile, for CA-signed keys.

Connection route¶

The route determines how the connection is dialled.

The jump-chain builder — Direct, through a chain of jump hosts, or through a command that provides the transport.

Direct writes nothing.
Jump hosts writes the chain, in order, as ProxyJump a,b,c. Each hop is either an alias from the configuration or a bare user@host:port. Muxus dials the hops in sequence and rejects a chain that loops back on itself.
ProxyCommand takes a command that provides the transport on stdin/stdout, such as cloudflared access ssh --hostname %h. The %h, %p and %r tokens are expanded at dial time.

Port forwarding¶

Forwards declared here are written into the block as LocalForward, RemoteForward or DynamicForward, and start with every session to this host.

To start a forward on demand instead, without opening a terminal, save it as a tunnel.

Session logging & highlighting¶

Two per-host overrides of the global settings:

Session logging inherits the global policy, or forces retention on or off for this host, including whether keystrokes are recorded.
Highlighting adds keyword rules for this host's terminals, either in addition to or instead of the global rules.

Advanced¶

Any other keyword OpenSSH understands is entered here as free-form option/value pairs. The panel shows the exact block that will be written.

The exact ssh_config block preview — Free-form keywords, with a preview of the resulting block.

Saving¶

The footer offers Save and Save & connect. The second writes the block and opens a session to it immediately.

Duplicating a host copies every field into a new block with a fresh alias. Deleting a host removes only its block from the file it lives in.