SSH, also known as "Secure Shell" or "Secure Socket Shell," is a network protocol that gives users a secure way to access a computer over an unsecured network.
Using SSH with your Casa Node allows you to view and interact with the CLI (Command Line Interface) of your Node from your laptop or desktop computer.
We must advise that making any changes via the CLI outside of our direct instruction is not recommended and does void your Node's warranty. You are free to make alterations to your Node via the CLI (it's your node!) but we cannot promise support or replacement if something does go wrong.
Using SSH with your Casa Node is only needed to help our engineers diagnose rare errors. We do not recommend enabling it other than temporarily if instructed to do so by support staff. If you choose to enable it permanently, make sure you change the default password by running the "passwd" command!
For Windows Users:
If you are using a Windows computer, we ask that you download a program called "Putty" prior to the call. Putty will allow you to connect to your node and display information directly on your Windows computer, and can be downloaded here: https://www.putty.org/
Putty is downloaded, but isn't installed on your machine - it is simply an executable that we will run from the downloads folder. It will get removed whenever you clear out your downloads folder.
Once you've downloaded Putty, please also log into your Casa Node using the monitor and keyboard with:
Once you're logged in to your Casa Node, you can run the following command:
sudo systemctl start ssh
Back to the Putty terminal on your laptop, you can:
1. Enter your Casa Node's IP address into the "IP" field.
2. Enter "Port 22" in the "Port" field. Click here for help on how to find your node's IP address.
3. When prompted for the username and password, simply enter in: casa as the username and casa as the password
You're now able to view and control your Casa Node's CLI (Command Line Interface) from your Windows computer!
For Mac Users:
If you are a Mac user, you can simply use "Terminal," an app that comes pre-loaded with your Mac.
Please also log into your node using the monitor and keyboard with:
Once you're logged in, you can run the following command on your node:
sudo systemctl start ssh
Using the Terminal App on your Mac laptop or Desktop, you can type:
ssh casa@(your IP)
For example, if your IP address was 192.168.4.81 you would type "ssh email@example.com" in Terminal. Click here for help on how to find your node's IP address.
When prompted for a password, simply enter in: casa
You're now able to view and control your Casa Node's CLI (Command Line Interface) from your Mac!
If you need assistance setting up SSH prior to your scheduled one-on-one call, please ask the support agent you were working with to set up your call by replying to their email. You can also email firstname.lastname@example.org if you don't currently have an open email case.