Skip to content

Commit 59abdc7

Browse files
authored
Connection Dropdown Photo in docs (#1242)
1 parent d5297cc commit 59abdc7

2 files changed

Lines changed: 10 additions & 2 deletions

File tree

docs/docs/connections.mdx

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,10 @@ Wave allows users to connect to various machines and unify them together in a wa
1212

1313
The easiest way to access connections is to click the <i className="fa-sharp fa-laptop"/> icon. From there, you can either type `[user]@[host]` for a desired SSH remote or type `wsl://<distribution name>` for a desired WSL distribution. Alternatively, if the connection already exists in the dropdown list, you can either click it or navigate to it with arrow keys and press enter to connect.
1414

15+
![a dropdown showing a list of connections that already exist](/img/connection-dropdown.png)
16+
1517
## What are wsh Shell Extensions?
18+
1619
`wsh` is a small program that helps manage waveterm regardless of which machine you are currently connected to. In order to not interrupt the normal flow of the remote session, we install it on your remote machine at `~/.waveterm/bin/wsh`. Then, when wave connects to your connection (and only when wave connects to your connection), `~/.waveterm/bin` is added to your `PATH` for that individual session. For more info on what `wsh` is capable of, see [wsh command](/wsh). And if you wish to view the source code of `wsh`, you can find it [here](https://github.com/wavetermdev/waveterm/tree/main/cmd/wsh).
1720

1821
## Add a New Connection to the Dropdown
@@ -22,13 +25,14 @@ The SSH values that are loaded into the dropdown by default are obtained by pars
2225
WSL values are added by searching the installed WSL distributions as they appear in the Windows Registry.
2326

2427
## SSH Config Parsing
28+
2529
At the moment, we are capable of parsing any SSH config file that does not contain the `Match` keyword. This keyword is incompatible with a library we are using, but we are hoping to fix that soon. While all other valid keywords are parsed, we only support the functionality of a small subset of them at the moment:
2630
| Keyword | Description |
2731
|---------|-------------|
2832
| Host | The pattern to match when attempting to connect via `[user]@[host]`. We list hosts that do not contain any wildcards characters (`*`, `?`, or `!`). Even if a host pattern contains wildcards, it will still be parsed when determining the values associated with the keys as usual.|
2933
| User | The user of the SSH remote connection. This will default to the current user on the local machine if not specified.|
3034
| Port | The port to connect to the remote on. `22` is the default if not specified.|
31-
| IdentityFile | This can be specified more than once per host. It gives the path to a private identity file (id_rsa, id_ed25519, id_ecdsa, etc.) that is used to authenticate the connection. Each will be tried in order, and they can be encrypted with a passphrase if desired. If no value is set, the default is to try in order: ~/.ssh/id_rsa, ~/.ssh/id_ecdsa, ~/.ssh/id_ecdsa_sk, ~/.ssh/id_ed25519_sk, ~/.ssh/id_dsa.|
35+
| IdentityFile | This can be specified more than once per host. It gives the path to a private identity file (id_rsa, id_ed25519, id_ecdsa, etc.) that is used to authenticate the connection. Each will be tried in order, and they can be encrypted with a passphrase if desired. If no value is set, the default is to try in order: ~/.ssh/id_rsa, ~/.ssh/id_ecdsa, ~/.ssh/id_ecdsa_sk, ~/.ssh/id_ed25519_sk, ~/.ssh/id_dsa.|
3236
|BatchMode| If set to true, user interaction via password, challenge/response, and publickey passphrase authentication will be disabled. It is set to false by default.|
3337
|PubkeyAuthentication| (partial) This is used to specify if pubkey authentication should be attempted. It is partially implementented as the `unbound` and `host-bound` values simply work the same as the `yes` value. The default is `yes`.|
3438
|PasswordAuthentication| This is used to specify if password authentication should be attempted. The default is `yes`.|
@@ -38,15 +42,19 @@ At the moment, we are capable of parsing any SSH config file that does not conta
3842
|ProxyJump| Specifies one or more jump proxies in a comma separated list. Each will be visited sequentially using TCP forwarding before connecting to the desired connection (also using TCP forwarding). It can be set to `none` to disable the feature.|
3943

4044
### Example SSH Config Host
45+
4146
For a quick example, a host in your config file may look like:
47+
4248
```
4349
Host myhost
4450
User username
4551
HostName 203.0.113.254
4652
IdentityFile ~/.ssh/id_rsa
4753
AddKeysToAgent yes
4854
```
55+
4956
You would then be able to access this connection with `myhost` or `username@myhost`. And if you wanted to manually specify a port such as port 2222, you could do that by either adding `Port 2222` to the config file or connecting to `username@myhost:2222`.
5057

5158
## Managing Connections with the CLI
52-
The `wsh` command gives some commands specifically for interacting with the connections. You can view these [here](/wsh#conn).
59+
60+
The `wsh` command gives some commands specifically for interacting with the connections. You can view these [here](/wsh#conn).
150 KB
Loading

0 commit comments

Comments
 (0)