SSH Remote
Prerequisites
For SSH remote access, both devices must be on the same local network, and the target device must have the SSH service enabled.
Our provided system image has SSH service enabled by default. If SSH is not installed or enabled, you can follow this tutorial to set it up!
Install OpenSSH
SSH remote control requires OpenSSH. Run the following command in the terminal of the mainboard to install it:
sudo apt update && sudo apt install openssh-server -y
Start SSH Service
Run the following command in the terminal of the mainboard to start the SSH service:
sudo systemctl start ssh
Enable SSH Service on Boot
Run the following command in the terminal of the mainboard to enable SSH service on boot:
sudo systemctl enable ssh
Check SSH Service Status
Run the following command in the terminal of the mainboard to check the SSH service status:
sudo systemctl status ssh
The terminal will display information similar to the following, indicating whether the SSH service is enabled on boot and its current status.
● ssh.service - OpenBSD Secure Shell server
Loaded: loaded (/lib/systemd/system/ssh.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2000-01-01 00:14:50 UTC; 25 years 5 months ago
Docs: man:sshd(8)
man:sshd_config(5)
Main PID: 518 (sshd)
CPU: 284ms
CGroup: /system.slice/ssh.service
└─518 sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups
SSH Remote Control
You can use either the terminal command line or Tabby software for SSH remote login.
- Terminal Command Line
- Using Tabby Software
Open a terminal on another device and enter the following command to log in remotely:
ssh <user-name>@<ip-address>
# Example
ssh [email protected]
Where <user-name> and <ip-address> are the actual username and IP address of the target device.
You will be prompted to confirm the connection by typing yes.
Tabby is a powerful cross-platform serial debugging tool that supports various protocols including serial and SSH. We recommend using Tabby for SSH remote login.
Download Tabby
Visit the Tabby official website to download and install the Tabby software.
Install Tabby
- Windows
Select the appropriate .exe file for your system architecture.
- Linux
Choose the .deb file that matches your system architecture.
- MacOS
Download the .dmg file for your system architecture.
Using Tabby
Double-click the Tabby icon to launch the application.
SSH Configuration
① → Settings: Click the settings option
② → Profiles & connections: Click to configure connection options
③ → New profile: Click to add a new configuration
Select SSH Template
Choose a base configuration as a template: Select the SSH connection template. You can modify parameters such as device name, IP address, and port in the subsequent configuration interface.
After selecting the SSH connection template, modify the following parameters:
① → Name: Set the connection name
② → Host: Enter the IP address of the target device
③ → User: Set the username (default is radxa for factory settings)
④ → Save: Save the configuration
The default port is 22 and typically doesn't need to be changed.
Run SSH Connection
Click the run button to establish the SSH connection.
After clicking the run button, Tabby will display a key verification and password input interface.
① → password: Enter the password for the target device
② → OK: Confirm the connection
It's recommended to check the Remember option so you won't need to enter the password again for future connections.
After a successful connection, the remote terminal interface will appear.
Once you've successfully logged in via SSH, you can run commands to control the system through the SSH session.