> For the complete documentation index, see [llms.txt](https://docs.jcore.io/clarity-gateway/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jcore.io/clarity-gateway/installation/readme/ssh-access.md).

# 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 %}