Establish remote SSH connection

Access information for SSH connection:

  • Username: root

  • Password: root

If you are unable to connect, check that Red Pitaya is connected to your local network.

Connection instructions are available for:

Windows 10

On Windows you can establish an SSH connection directly through the Command Prompt or use a program like PuTTy or WinScp. Here we will discuss both options.

Command Prompt

To establish an SSH connection through the Command Prompt, first open the Command Prompt console window (search for “command prompt” in Windows Search).

Enter the following command:

ssh root@<Red Pitaya IP address>

If you attempt to connect to Red Pitaya for the first time, a security alert will display asking you to confirm the connection (type “yes”). At this time, the ssh-key will be added to the registry on your computer.

Next, the console will ask for a password (root).

After the password was entered, the login text will appear. Here is a picture of the whole exchange:

../../../../_images/ssh_console_win.png

The last command prompt/terminal line should read as “root@rp-xxxxxx:~#“ (the default home directory on Red Pitaya is /root).

Note

After updating the OS or after some time has passed since the last SSH connection, you might get the following message when trying to establish an SSH connection.

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that the RSA host key has just been changed.
The fingerprint for the RSA key sent by the remote host is
06:ea:f1:f8:db:75:5c:0c:af:15:d7:99:2d:ef:08:2a.
Please contact your system administrator.
Add correct host key in /home/user/.ssh/known_hosts to get rid of this message.
Offending key in /home/user/.ssh/known_hosts:4
RSA host key for domain.com has changed and you have requested strict checking.
Host key verification failed.

Do not worry, nothing is wrong with your Red Pitaya. The problem is that the Red Pitaya identification key has changed. To fix this use the following code:

ssh-keygen -R rp-xxxxxx.local

And try to establish the SSH connection again.

Alternatively, open Explorer and go to C:/Users/<your-username>/.ssh and open the known_hosts file. Delete all lines containing rp-xxxxxx.local.

Connection via a program (PuTTy, WinSCP, …)

For this example, the PuTTy and WinSCP tools were used on Windows 11. Run PuTTy/WinSCP and enter the Red Pitaya’s IP (or .local) address into the Host Name (or IP address) field.

../../../../_images/ssh_putty_config.png

PuTTy SSH connection settings.

../../../../_images/ssh_winscp_config.png

WinSCP SSH connection settings.

Make sure the port number is set to 22. Fill the “User name” as root on WinSCP. Then select Open/Login.

Input password root.

If you attempt to connect to Red Pitaya for the first time, a security alert will pop up asking you to confirm the connection. At this time, the ssh-key will be added to the registry on your computer. A command prompt pops up after login is successful.

../../../../_images/ssh_putty_alert.png

When connected to RP via SSH, you get the following command prompt screen:

../../../../_images/ssh_putty.png

SSH connection via PuTTy

../../../../_images/ssh_winscp_con.png

SSH connection via WinSCP

The last command prompt/terminal line should read as “root@rp-xxxxxx:~#“ (the default home directory on Red Pitaya is /root).

Linux

Start Terminal and type (replace the IP address with the right one):

user@ubuntu:~$ ssh root@192.168.1.100
root@192.168.1.100's password: root
Red Pitaya GNU/Linux/Ecosystem version 0.90-299
redpitaya>
../../../../_images/linux_terminal.png

macOS

Run terminal Launchpad → Other → Terminal and type (replace the IP address with the right one):

localhost:~ user$ ssh root@192.168.1.100
root@10.0.3.249's password: root
Red Pitaya GNU/Linux/Ecosystem version 0.90-299
redpitaya>