*Extracted from Onion Omega Documentation.

Connecting with SSH #

SSH stands for Secure Shell . It’s a network protocol that creates a secure channel for communication between two devices on the same network. It can be used to secure many different types of communication, but here we’ll be using it to login to the meter’s command prompt.

The Good & Bad of SSH #

When using SSH, the meter and your computer communicate over the WiFi network to which they are both connected. This means that as long as the meter is powered on and within range of your WiFi network, you can connect to it. The disadvantage of SSH is that if the network connection gets interrupted, the connection will also be severed.

The Connection method #

The connection method will be different depending on what Operating System you’re using on the computer used to connect. We’ve included guides for the following:

SSH on a Mac device #

Step 1: Open a Terminal
Open your preferred Terminal App.

Step 2: Establishing a SSH connection
Run the following command:

ssh root@omega-ABCD.local

Where ABCD is the unique id of your meter.

osx ssh

Step 3: Enter Credentials
When prompted, enter the provided password

osx ssh

If you’re prompted about adding the address to the list of known hosts, type yes. This is just your computer getting to know the Omega for the first time!

And you’re in!

osx ssh

SSH on a Linux device #

Step 1: Open a Terminal
Open your preferred Terminal App.

Step 2: Establishing a SSH connection
Run the following command:

ssh root@omega-ABCD.local

Where ABCD is the unique id of your meter.

linux ssh

Step 3: Enter Credentials
When prompted, enter the given password.

linux ssh

If you’re prompted about adding the address to the list of known hosts, type yes. This is just your computer getting to know the Omega for the first time!

And you’re in!

linux ssh

SSH on a Windows Device #

Step 1: Download PuTTy
You can find PuTTy here. Look for the putty.exe installer for Windows on intel x86. Once it’s downloaded you can open and use it.

Step 2: Establish a SSH connection
Configure an SSH connection to omega-ABCD.local on port 22:

putty ssh

Where ABCD is the unique id of your meter.

Step 3: Enter Credentials
Click Open and enter the credentials when prompted.

By default, the credentials are:
Username: root
Password: given password

And you’re connected!