Reference
This machine
| Item | What it means |
|---|---|
| SSH server | Whether other machines can sign in to this one |
| CrossShell SSH key | The key this machine uses to sign in to others |
| Finding machines on the network | Discovery, broadcasting on UDP 47820 |
| Accepting pairing requests | Pairing, listening on TCP 47820 |
| Screen sharing agent | The helper that shares this screen |
| Re-check | Runs the checks again |
| Open firewall for the local network | Allows SSH, pairing and discovery from the local network |
| Let paired machines view and control this screen | Turns screen sharing on or off |
| SSH port on this machine | Change only if your SSH server listens somewhere other than 22 |
The page also shows this machine's CrossShell public key, with a Copy button.
Machine card
| Action | What it does |
|---|---|
| Terminal | Opens a terminal on that machine |
| Files | Opens the two-pane file manager |
| Remote desktop | Views and controls its screen |
| More › View screen only | Views its screen without control |
| More › Port forwards | Opens the Forwards tab |
| More › Open in system terminal | Runs ssh to it in your own terminal |
| More › Open in VS Code | Opens it with VS Code Remote-SSH |
| More › Check connection | Tests the connection |
| More › Unpair | Removes the trust between the machines |
Session shortcuts
| Action | Keys |
|---|---|
| Terminal tab | Ctrl + 1 |
| Files tab | Ctrl + 2 |
| Forwards tab | Ctrl + 3 |
| New terminal | Ctrl + Shift + T |
| Close terminal | Ctrl + Shift + W |
| Copy in terminal | Ctrl + Shift + C or Ctrl + Insert |
| Paste in terminal | Ctrl + Shift + V or Shift + Insert |
File pane shortcuts are listed in Transfer files.
Network ports
| Port | Used for |
|---|---|
| UDP 47820 | Finding other machines on the local network |
| TCP 47820 | Pairing, once per pair |
| TCP 22 (or your SSH port) | Everything after pairing: terminal, files, forwards, remote desktop |
Files CrossShell manages
| File | Purpose |
|---|---|
~/.ssh/crossshell/config | SSH names and settings of paired machines |
~/.ssh/crossshell/known_hosts | Identity keys of paired machines |
~/.ssh/crossshell/id_ed25519 | This machine's CrossShell key |
~/.ssh/config | One Include line at the top |
~/.ssh/authorized_keys | One marked line per paired machine |
On Windows administrator accounts, paired machines' keys go into C:\ProgramData\ssh\administrators_authorized_keys instead.