Configuration

Configuration

etr (client) options

etr [OPTIONS] [TARGET]

Arguments:
  [TARGET]              Remote host — user@host, host, or host:port

Options:
  -s, --ssh-port PORT   SSH port for bootstrap [default: 22]
  -v, -vv, -vvv         Verbosity level (see below)
  --server-path PATH    Path to etrs on the remote host [default: etrs]
  --completions SHELL   Print shell completions and exit
  -h, --help
  -V, --version

etrs (server) options

etrs is normally started by etr automatically. You can run it manually for testing:

etrs [OPTIONS]

Options:
  -p, --port PORT       UDP port to bind [default: 0 = OS-assigned]
  -b, --bind ADDR       IP address to bind [default: [::] = dual-stack]
  -v, -vv, -vvv         Verbosity level (see below)
  -h, --help
  -V, --version

Verbosity levels

Both binaries use SSH-style -v counting:

Flag	What you see
(none)	Silent
-v	Connection events: connect, reconnect, disconnect, timeout
-vv	Cipher suite negotiated, session ID, port
-vvv	Every packet: type, sequence number, size, peer address

Client verbose logs are written to ~/.local/state/etr/etr.log during a live session (to avoid corrupting the raw-mode terminal display). A single line on stderr tells you the path. Watch it with:

tail -f ~/.local/state/etr/etr.log

Server logs go to ~/.local/state/etr/etrs.log on the remote host.

Server not in PATH

If etrs is installed somewhere not on the SSH session PATH:

etr --server-path /home/user/.cargo/bin/etrs user@host

SSH non-interactive sessions often have a minimal PATH. The safest fix is to add ~/.cargo/bin to PATH unconditionally in ~/.bashrc or ~/.zshrc (not just in the interactive section).

Disabling post-quantum crypto

PQC (ML-KEM-1024) is on by default. To build without it:

cargo install etr --no-default-features

Both client and server must agree — if the server has PQC disabled, the client will fall back to X25519 automatically during negotiation.

Shell completions

# Zsh
etr --completions zsh > ~/.zfunc/_etr
# then add `fpath=(~/.zfunc $fpath)` and `autoload -Uz compinit && compinit` to ~/.zshrc

# Bash
etr --completions bash > /etc/bash_completion.d/etr

# Fish
etr --completions fish > ~/.config/fish/completions/etr.fish

# Nushell
etr --completions nushell | save completions-etr.nu