Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified docs/img/use-teleport/connect-cluster.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/img/use-teleport/connect-ui-overview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
26 changes: 16 additions & 10 deletions docs/pages/connect-your-client/teleport-connect.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,10 +54,12 @@ The top bar of Teleport Connect consists of:
Teleport clusters as well as log in or out of the clusters.
- The **connection list** (the top left) showing recent connections, allowing you to seamlessly switch
between them.
- The **command bar** (in the middle), which launches any command you input in a new terminal tab.
- The **cluster selector** (to the left of the command bar), which shows up only if you have set up
- The **search bar** (in the middle), which allows you to search for resources across clusters.
- The **cluster selector** (to the left of the search bar), which shows up only if you have set up
Trusted Clusters and there are leaf clusters connected to the root cluster. It lets you browse
leaf cluster resources. It also changes which cluster the commands in the command bar are going to target.
leaf cluster resources. Also, the "Open new terminal" action will bind new terminal tabs to the selected cluster.
- The **additional actions menu** (to the left of the profile selector), containing options such as
opening a config file or creating an access request in an Enterprise cluster.

## Connecting to an SSH server

Expand All @@ -67,8 +69,7 @@ The top bar of Teleport Connect consists of:
3. Select or enter the SSH user you wish to log in as and press `Enter`.
4. A new tab will open with a shell session on the chosen server.

Alternatively, you can type `tsh ssh` into the command bar in the Teleport Connect window, and the autocompletion will help
you connect to a server.
Alternatively, you can look for the server in the search bar and press `Enter` to connect to it.

## Connecting to a Kubernetes cluster

Expand All @@ -81,6 +82,8 @@ you connect to a server.
the `$KUBECONFIG` environment variable (`kubectl`, `helm`, etc.) will work without additional configuration.
To identify the path to this config for use in other tools, run `echo $KUBECONFIG`.

Alternatively, you can look for the cluster in the search bar and press `Enter` to connect to it.

## Connecting to a database

1. Open a tab with cluster resources by clicking on the plus symbol at the end of the tab bar. You
Expand All @@ -90,6 +93,8 @@ you connect to a server.
4. Select or enter the database user you with to use and press `Enter`.
5. A new tab will open with a new connection established between your device and the database server.

Alternatively, you can look for the database in the search bar and press `Enter` to connect to it.

This connection will remain active until you click the Close Connection button or close Teleport
Connect. The port number will persist between app restarts—you can set up your favorite client
without worrying about the port suddenly changing.
Expand Down Expand Up @@ -141,8 +146,8 @@ through tsh will not make that cluster show up in Teleport Connect.

<Tabs>
<TabItem label="macOS">
To add tsh to `PATH`, execute `tsh install` from the command bar in Teleport Connect. This will
symlink tsh to `/usr/local/bin`. You can remove the symlink with `tsh uninstall`.
To add tsh to `PATH`, open the additional actions menu and select "Install tsh in PATH". This will
symlink tsh to `/usr/local/bin`. You can remove the symlink by selecting "Remove tsh from PATH".

If you used the tsh macOS .pkg installer before, this will overwrite the symlink made by that installer.
</TabItem>
Expand All @@ -160,7 +165,7 @@ installation directory to the `Path` user environment variable.
## Configuration

Teleport Connect can be configured by editing the `app_config.json` file, which it creates on first launch.
To open it, click the More Options icon `⋮` -> Open Config File.
To open the config file, select "Open config file" from the additional actions menu.
The file will open in your default editor.

<Admonition
Expand All @@ -178,12 +183,13 @@ Below is the list of the supported config properties.
| `keymap.tab1` - `keymap.tab9` | `Command+1` - `Command+9` on macOS <br/> `Ctrl+1` - `Ctrl+9` on Windows<br/>`Alt+1` - `Alt+9` on Linux | Shortcut to open tab 1–9. |
| `keymap.closeTab` | `Command+W` on macOS<br/>`Ctrl+W` on Windows/Linux | Shortcut to close a tab. |
| `keymap.newTab` | `Command+T` on macOS<br/>`Ctrl+T` on Windows/Linux | Shortcut to open a new tab. |
| `keymap.newTerminalTab` | `Shift+Command+T` on macOS<br/>`Ctrl+Shift+T` on Windows/Linux | Shortcut to open a new terminal tab. |
| `keymap.previousTab` | `Shift+Command+Tab` on macOS<br/>`Ctrl+Shift+Tab` on Windows/Linux | Shortcut to go to the previous tab. |
| `keymap.nextTab` | `Command+Tab` on macOS<br/>`Ctrl+Tab` on Windows/Linux | Shortcut to go to the next tab. |
| `keymap.openConnections` | `Command+P` on macOS<br/>`Ctrl+P` on Windows/Linux | Shortcut to open the connection list. |
| `keymap.openClusters` | `Command+E` on macOS<br/>`Ctrl+E` on Windows/Linux | Shortcut to open the cluster selector. |
| `keymap.openProfiles` | `Command+I` on macOS<br/>`Ctrl+I` on Windows/Linux | Shortcut to open the profile selector. |
| `keymap.openCommandBar` | `Command+K` on macOS<br/>`Ctrl+K` on Windows/Linux | Shortcut to open the command bar. |
| `keymap.openSearchBar` | `Command+K` on macOS<br/>`Ctrl+K` on Windows/Linux | Shortcut to open the search bar. |
| `terminal.fontFamily` | `Menlo, Monaco, monospace` on macOS<br/>`Consolas, monospace` on Windows<br/>`'Droid Sans Mono', monospace` on Linux | Font family for the terminal. |
| `terminal.fontSize` | 15 | Font size for the terminal. |

Expand Down Expand Up @@ -330,7 +336,7 @@ To remove the local user data directory:

```code
$ rm -rf ~/Library/Application\ Support/Teleport\ Connect
```
```

</TabItem>
<TabItem label="Windows">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ function getActiveRootCluster(ctx: IAppContext): Cluster | undefined {
return ctx.clustersService.findCluster(clusterUri);
}

export function MoreOptions() {
export function AdditionalActions() {
const [isPopoverOpened, setIsPopoverOpened] = useState(false);
const selectorRef = useRef<HTMLButtonElement>();

Expand All @@ -155,7 +155,7 @@ export function MoreOptions() {
<TopBarButton
ref={selectorRef}
isOpened={isPopoverOpened}
title="More Options"
title="Additional Actions"
onClick={() => setIsPopoverOpened(true)}
>
<icons.MoreVert fontSize={6} />
Expand Down
4 changes: 2 additions & 2 deletions web/packages/teleterm/src/ui/TopBar/TopBar.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ import { useAppContext } from '../appContextProvider';
import { Connections } from './Connections';
import { Clusters } from './Clusters';
import { Identity } from './Identity';
import { MoreOptions } from './MoreOptions';
import { AdditionalActions } from './AdditionalActions';

export function TopBar() {
const { configService } = useAppContext();
Expand All @@ -41,7 +41,7 @@ export function TopBar() {
{isSearchBarEnabled ? <SearchBar /> : <QuickInput />}
</CentralContainer>
<JustifyRight>
<MoreOptions />
<AdditionalActions />
<Identity />
</JustifyRight>
</Grid>
Expand Down