Set up
1
Install the SSH library
- Python
- TypeScript
2
Pick a port
3
Authorize your key
4
Restart the server
Settings
Settings
An environment variable wins over
~/.mirage/config.toml, which wins over the
default.The server makes its host key on first start and keeps it, so your
known_hosts entry stays valid.Connect
Each run gets a fresh session, so a
cd or export never leaks between them.
Ctrl-C cancels the running line, and ssh host cmd exits with the line’s status.
To mount a folder on the machine running Mirage instead, use FUSE.
Over HTTPS
A hosted server carries SSH over its HTTPS port, so it needs no SSH port or key.mirage ssh-proxy relays it with the CLI’s token:
~/.ssh/config
ssh demo@mirage, sftp demo@mirage, scp notes.txt demo@mirage:/data/
and sshfs -o direct_io demo@mirage:/ ~/mnt/demo all work. The CLI sends its
token, your mirage login on a hosted server, and the
login runs under the workspace’s default profile.
Auth (optional)
Inlocal and token mode, an authorized key opens every workspace under the
workspace’s default profile. Options in front of a key in authorized_keys
narrow it:
~/.mirage/ssh/authorized_keys
On a
jwt server, each login reaches only its
account’s workspaces:
Account rules in detail
Account rules in detail
- The account holds for shell, exec,
sftpandscpalike. - In
localandtokenmode, a key withoutmirage-accountopens every workspace. - An option that is empty or given twice opens nothing.
How sessions behave
How sessions behave
- Each
ssh,sftporscprun gets a fresh session, closed when it ends. - The session’s profile and the mount modes apply as in any shell: a
read-only mount refuses
sftp put. - Output streams as the line prints it.
- Ctrl-C cancels the running line and sets
$?to 130. A dropped connection cancels it too. - The server sends a keepalive every 15 seconds and closes a connection that misses three, so a half-open one cancels its line as well.
- Nothing is forwarded: no ports, no agent, no X11.