# SSH Access

The Iron Pi ships with SSH enabled, which allows you to securely log into the device and run commands in a command line environment.

{% tabs %}
{% tab title="Windows" %}
To access your device via SSH from Windows, download and install an SSH client. [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) is a popular SSH client on Windows. Download, install, and open PuTTY. In the "PuTTY Configuration" screen, enter the IP address of your device, and click "Open" to connect.

![](/files/0iGYhsLI7x4auK1mD3fj)

#### SSH Security Warnings

The first time you connect to any SSH device from your computer, you will get a warning about the device being unrecognized. You can safely ignore this warning and click "Accept" to continue connecting to the device.

![](/files/dZfMD4A25bQXqHGWvSfV)

If you connect to multiple devices that have the same IP address, you will get a warning like the one below. It is safe to click "Accept" and ignore that warning if you know you previously connected to a different unit that was using the same IP address.

![](/files/YaH1RnkZkjPIDv8dBpJU)

#### Password Authentication

You will be asked to authenticate with the device. If the device is an Iron Pi, Log in with the username `pi`, and whatever password you set during the [Setting the Password](/clarity-gateway/installation/readme/setting-password.md) process. If you have not set your device's password, then the SSH password will be the 8-letter access code from the label above the Power / CPU light on the Iron Pi.

{% hint style="warning" %}
SSH passwords are case sensitive! The Iron Pi's factory access codes use all uppercase letters.
{% endhint %}

![](/files/gMlPXWcnZNokKAQNzbVP)

Once you've logged in successfully, you should see a command prompt like this:

![](/files/wNz9EYEpN3WhdMajAccQ)
{% endtab %}

{% tab title="MacOS/Linux" %}
To access the Iron Pi from a MacOS or Linux, open a terminal and type ssh -l pi \<IP ADDRESS>, e.g. ssh -l pi 192.168.1.220. Accept the security warning if it is your first time connecting to the device, and enter the username and password as described above.

![](/files/bpyZhEjuVrkGuOlmOF5T)
{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://docs.jcore.io/clarity-gateway/installation/readme/ssh-access.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.