> For the complete documentation index, see [llms.txt](https://docs.connect.jfrog.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.connect.jfrog.io/features-new-ui/tools/remote-tools-overview/remote-access/connect-with-ssh.md).

# Connect with SSH

You can gain port tunneling access to your edge device using a number of different tunneling methods. This page describes an example procedure using [SSH](https://en.wikipedia.org/wiki/Secure_Shell) to access the device.

## Prerequisites

* At least one online device.
* The following software installed on the device: `ssh-server` and `ssh-client`.
* If you are using a Windows-based computer and you don’t have SSH enabled, you may want to refer to the How-to Geek’s article [How to Enable and Use Windows 10's New Built-in SSH Commands](https://www.howtogeek.com/336775/how-to-enable-and-use-windows-10s-built-in-ssh-commands/) to setup SSH.

## Open SSH Port Tunneling Session

To start an SSH remote access session, do the following:&#x20;

1. Go to **Remote Tools**/**Port Tunnel** and choose the device you want to access. Only online devices are shown in the dropdown list.
2. Enter the SSH port for your device. By default, SSH connections are routed through port 22. If you are using OpenSSH with a port other than 22, enter that port number here.

<div align="left"><figure><img src="/files/kqY5mG9Wb5Y13ZzCweYE" alt=""><figcaption></figcaption></figure></div>

3. Click **Open Tunnel**. Wait until Connect produces the remote access address as shown below. You will use parts of this address to construct a command as shown in the next step and the example below.

<div align="left"><figure><img src="/files/sAZ9CbNytzmHS41cw8MK" alt="" width="563"><figcaption></figcaption></figure></div>

## Open a Terminal Window

1. Open a terminal window, type in the command below, and substitute the values that Connect provided in the remote access address. (See example below.) Type **Enter**.\
   \
   `ssh <username>@<hostname> -p <port>`

Example:

Here is an example of a ready SSH command:

`ssh root@d-e571-1261-egrffkb3qhq.forwarding.connect.jfrog.io -p 22277`

Where the parameters are:

* `<username>` – A user account name (or root) on your Linux edge device.
* `<hostname>` – The full URL you received from JFrog Connect remote access session window.
* `<port>` – The port you received from JFrog Connect remote access session window.

2. After the above command runs, you will be prompted for your Linux device user password. Enter it right away. After your credentials are verified, you will be connected to your device through a secure SSH connection.

{% hint style="info" %}
**Tip**: If your SSH connection command is not getting a response after a few seconds, type Ctrl+C and run the command again.
{% endhint %}

## What’s Next?

Learn how to [Access Device Web Applications](/features-new-ui/tools/remote-tools-overview/remote-access/access-device-web-applications.md) on your edge device.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.connect.jfrog.io/features-new-ui/tools/remote-tools-overview/remote-access/connect-with-ssh.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
