> 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.

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-634da2c93190970653e6181cac02cc72c52c4548%2F01%20PuTTY%20start.png?alt=media)

#### 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.

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-b628e378f2591d175caccb232b99fef35abc6872%2F02%20Unknown%20Device.png?alt=media)

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.

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-edfac214348d544f513ea1a5bf6bd7c11444d434%2F05%20potential%20security%20breach.png?alt=media)

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

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-aa5035309178ec59dd2d53543085424a37cd7d1e%2F03%20username.png?alt=media)

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

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-f6bd2deeb2a4f94957b347ce8a078eddd707894a%2F04%20successful%20login.png?alt=media)
{% 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.

![](https://1557066017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSPy42kVbNL57hubF20gF%2Fuploads%2Fgit-blob-ba4ac9b2f486bfbfed1f8bfbeb95590472debf06%2F06%20mac%20OS%20SSH%20login.png?alt=media)
{% endtab %}
{% endtabs %}