====== 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 connecting to and ''username'' with your username (e.g., the default username is ''khadas''):

```shell
ssh <username>@<ip address>
```
When the connection is established, 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 a command prompt similar to the following:

```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. It provides a user with a graphical interface to connect to another computer over a network connection. The user uses RDP client software for this purpose, while the target 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 your password:

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

Enable ''Remote Login'' and set up username and password in the ''Login Details'' section:

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

<WRAP important >
**You need to log out before you can log in with RDP client.**
</WRAP>


=== Ubuntu 22.04 ===

Go to ''Settings->Sharing->Remote Desktop'', enable ''Remote Desktop'' and ''Remote Control'', and change the default authentication password under the ''Authentication'' section if desired:

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

<WRAP important >
**Enable Auto Login**

You will not be able to log in remotely if there are no active user sessions, so you need to enable auto login. Go to ''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 an RDP server ====

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


=== Connect on Windows ===

Open the ''Remote Desktop Connection'' application, enter the IP address, click ''Connect'', and then enter the username and password.

=== Connect on Linux ===

You need to install ''Remmina'':

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

Open ''Remmina'', select ''RDP'', enter the IP address, and press ''Enter''. Then enter the username and password and 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 ===

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