Table of Contents

Ubuntu Desktop - Getting Started Guide

Your Ubuntu Desktop server based on Ubuntu 24.04 provides a full graphical desktop environment accessible via RDP (Remote Desktop Protocol). Connect from any device using a standard RDP client – no additional software installation on the server is needed. The desktop is ready to use immediately after your server is created.


Step 1 – Connect via RDP

Your server’s IP address and root password are shown in the Server Information section on the Overview tab of your server in the client portal. The same credentials are used for RDP, SSH and the Console in the client portal.

Use any RDP client to connect to your desktop:

Platform RDP Client
WindowsBuilt-in Remote Desktop (mstsc)
macOSMicrosoft Remote Desktop (App Store)
LinuxRemmina
iOS / AndroidRD Client / Remote Desktop

Connection settings:

  • Host: your.server.ip
  • Port: 3389 (default)
  • Username: root
  • Password: from the client portal

The connection is encrypted with TLS. On the first connection your RDP client warns that the server’s certificate cannot be verified: each server creates its own self-signed certificate on first boot. Accept it (in Windows Remote Desktop you can tick “Don’t ask me again for connections to this computer”). The XFCE desktop opens after login.

If you placed the server behind a VyOS router on a private network, either forward ports 22 (SSH) and 3389 (RDP) to the server on the router’s Configuration tab (Port forwarding), or reach the desktop on the server’s private IP through a VPN on the router (WireGuard or OpenVPN, on the router’s Configuration tab). A VPN is safer: an RDP port open to the internet attracts password guessing.


Step 2 – Connect via SSH (Optional)

For command-line access, connect via SSH:

ssh root@your.server.ip

Post-Installation

Root Login Warning

When you log in via RDP or SSH, you may see a warning about running as root. This is expected – all our templates use root access by default for convenience so you can configure the server immediately. You can create a regular user account later if needed.

Installing Additional Software

Install software using apt from the terminal or from the XFCE application menu:

# Install Chromium browser
apt update && apt install -y chromium-browser

# Install LibreOffice
apt install -y libreoffice

# Install VS Code
snap install code --classic

OS Updates

To update the system manually:

apt update && apt upgrade -y

Fail2Ban – Brute-Force Protection

Your server comes with Fail2Ban pre-configured to protect both SSH and RDP from brute-force attacks.

Rule Max Attempts Ban Duration
SSH5 failed logins1 hour
RDP (xrdp)5 failed logins within 10 minutes1 hour

Useful commands:

# Check banned IPs
fail2ban-client status xrdp
fail2ban-client status sshd

# Unban an IP
fail2ban-client set xrdp unbanip 1.2.3.4

If you accidentally lock yourself out, open the Console on your server’s Overview tab in the client portal and unban your IP.

Service Management

xrdp runs via systemd. Common commands:

# Check RDP service status
systemctl status xrdp

# Restart RDP
systemctl restart xrdp

# View xrdp logs (connections and failed logins)
tail -n 100 /var/log/xrdp.log
tail -n 100 /var/log/xrdp-sesman.log

What’s Pre-Configured

  • Dual desktops: XFCE for RDP (lightweight, fast) and Gnome for the Console in the client portal (emergency fallback)
  • Display mode: X11 (Wayland is not compatible with RDP on Ubuntu 24.04 – causes black screens)
  • Desktop update protection: core desktop packages (display server, login manager, xrdp, XFCE) are excluded from automatic updates to prevent RDP breakage. Security updates for other packages continue normally

Software Included

Component Details
Ubuntu24.04 LTS
RDP DesktopXFCE 4.18 (lightweight, fast)
Console DesktopGnome 46 (Console fallback)
RDP Serverxrdp 0.9.24 (port 3389, TLS)
BrowserFirefox (snap, updates automatically)
Text EditorMousepad
SecurityFail2Ban (SSH + RDP)

Troubleshooting

Problem Solution
Black screen after RDP login SSH in and restart xrdp: systemctl restart xrdp
RDP connection refused Check that xrdp is running: systemctl status xrdp. Restart if needed: systemctl start xrdp
Can’t connect via RDP or SSH Your IP may be banned by Fail2Ban. Use the Console on your server’s Overview tab in the client portal to unban: fail2ban-client set xrdp unbanip 1.2.3.4
Firefox or other apps won’t launch Open a terminal in XFCE and run: xhost +local:, then try again
RDP broken after system update Desktop packages may have been updated manually. SSH in and restart: systemctl restart xrdp. Use the Console on your server’s Overview tab in the client portal as fallback
Forgot root password Use the Console on your server’s Overview tab in the client portal to reset it