====== Remote access ======

===== Access a remote terminal with SSH =====

SSH (Secure SHell) provides secure access to a terminal session on your board.

You can access the terminal of a board remotely from another computer on the same network using the Secure SHell (SSH) protocol.

==== Connect to an SSH server ====

Open a terminal window on your computer and enter the following command, replacing the ''ip address'' placeholder \\
with the IP address of the board you are trying to connect to and ''username'' with your username, e.g. the default \\
username is ''khadas'':

```shell
ssh <username>@<ip address>
```
When the connection works, you will see a security warning. Type ''yes'' to continue. You will only see this warning the first time you connect.

Enter your account password when prompted. e.g. the default password is ''khadas''.

You should now see the command prompt:

```shell
$ ssh khadas@192.168.30.194
Warning: Permanently added '192.168.30.194' (ED25519) to the list of known hosts.
khadas@192.168.30.194's password:

Welcome to Fenix 1.6.9 Ubuntu 22.04.4 LTS Linux 5.15.119
 _  ___               _            __     _____ __  __ _  _
| |/ / |__   __ _  __| | __ _ ___  \ \   / /_ _|  \/  | || |
| ' /| '_ \ / _` |/ _` |/ _` / __|  \ \ / / | || |\/| | || |_
| . \| | | | (_| | (_| | (_| \__ \   \ V /  | || |  | |__   _|
|_|\_\_| |_|\__,_|\__,_|\__,_|___/    \_/  |___|_|  |_|  |_|


 * Website:        https://www.khadas.com
 * Documentation:  https://docs.khadas.com
 * Forum:          https://forum.khadas.com

Last login: Wed Sep 18 02:59:44 2024
```

===== Access a remote desktop with RDP =====

Remote Desktop Protocol ([[https://en.wikipedia.org/wiki/Remote_Desktop_Protocol | RDP]]) is a proprietary protocol developed by Microsoft Corporation which provides a user with a graphical interface \\
to connect to another computer over a network connection. The user employs RDP client software for this purpose, while the other computer \\
must run RDP server software.

==== Enable the RDP server ====

=== Ubuntu 24.04 ===

You need to upgrade system to latest version and install ''gnome-remote-desktop''.

```shell
sudo apt update
sudo apt full-upgrade 
sudo apt install gnome-remote-desktop
sync
sudo reboot
```

After reboot, goto ''Settings->System->Remote Desktop->Remote Login'', click ''Unlock'' and enter password:

{{:products:sbc:common:configurations:remote-login-24-04-1.webp?600|}}

Enable ''Remote Login'' and setup username and password in ''Login Details'' section:

{{:products:sbc:common:configurations:remote-login-24-04-2.webp?600|}}

<WRAP important >
**You need to logout before you to login with RDP client.**
</WRAP>


=== Ubuntu 22.04 ===

Goto ''Settings->Sharing->Remote Desktop'', enable ''Remote Desktop'' and ''Remote Control'', and change the default authentication password if you want \\
under ''Authentication'' section.

{{:products:sbc:common:configurations:remote-desktop.webp?600|}}

<WRAP important >
**Enable auto login**

You will not be able to login remotely if there are no active user sessions, so you need to enable auto login. Goto ''Settings->Users'', and click Unlock:

{{:products:sbc:common:configurations:auto-login-1.webp?600|}}

Then enter your password and turn on the Automatic login switch:

{{:products:sbc:common:configurations:auto-login-2.webp?600|}}</WRAP>




==== Connect to a RDP server ====

<WRAP tip >
If you get a black screen, please close the RDP client and try again.
</WRAP>


=== Connect on Windows system ===

Just open ''Remote Desktop Connection'' app, enter the IP address and click connect and enter the username and password.

=== Connect on Linux system ===

You need to install ''Remmina'':

```shell
sudo apt update
sudo apt install remmina remmina-plugin-rdp remmina-plugin-vnc
```

Open ''Remmina'' select ''RDP'' and enter the IP address and press ''Enter'' to enter the username and password, then click ''OK'':

{{:products:sbc:common:configurations:linux-rdp-1.webp?600|}}

{{:products:sbc:common:configurations:linux-rdp-2.webp?600|}}

{{:products:sbc:common:configurations:linux-rdp-3.webp?600|}}

=== Connect on macOS system ===

You can install ''Microsoft Remote Desktop'' client from Apple App Store to connect to a RDP server.