Clarity Gateway
  • Setup
    • Getting Started
      • Mounting and Wiring
        • Power and Ground Connections
        • Flexible I/O Connections
        • Serial Connections
        • USB and Ethernet
      • Network Layout
      • Accessing Clarity Gateway Web Interface
      • Setting Password
      • Entering License Key
      • Changing the IP address
      • Updating Software
      • 3rd Party Devices
        • Running the Installer Script
        • Moxa UC-8100-ME Setup
        • Runnning Clarity Gateway on a 3rd Party Device
        • Password Recovery on 3rd Party Devices
    • SSH Access
    • Serial Console Access
    • Adding USB Storage
  • Connections
    • EtherNet/IP
      • Adding an EtherNet/IP Connection
      • Receiving values from EtherNet/IP
      • Sending values to EtherNet/IP
    • MQTT
      • Adding a SparkPlug MQTT Connection
      • Adding a Text/JSON MQTT Connection
      • Sending values to MQTT
    • Modbus
      • Sending values to Modbus
      • Receiving values from Modbus
      • Adding a Modbus TCP Device
    • Local I/O
      • Configuring Analog Inputs
      • Configuring Digital Inputs
      • Configuring Digital Outputs
  • Transfer Data Between Connections
  • Channels
    • Setting Clarity Metadata
  • Other
    • Recovery
    • Settings Import/Export
      • Exporting Settings
      • Importing Settings
Powered by GitBook
On this page
  1. Setup

SSH Access

PreviousPassword Recovery on 3rd Party DevicesNextSerial Console Access

Last updated 1 day ago

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

To access the Iron Pi via SSH from Windows, download and install an SSH client. is a popular SSH client on Windows. Download, install, and open PuTTY. In the "PuTTY Configuration" screen, enter the IP address of the Iron Pi, and click "Open" to connect.

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.

If you connect to multiple Iron Pi units 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.

Password Authentication

SSH passwords are case sensitive! The 8-letter factory access code uses all uppercase letters.

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

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.

Disabling SSH

The Iron Pi comes from the factory with SSH enabled. If you would like to disable it, follow these steps.

Click the Security link in the sidebar:

Then in the Security page, click the SSH Disabled button:

A popover will ask you to confirm that you want to disable SSH; click OK:

After this SSH Disabled will be highlighted:

You will be asked to authenticate with the device. Log in with the username pi, and whatever password you set during the 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.

Setting the Password
PuTTY