aevrin/remote-desktop repository overview

⁠docker-remote-desktop

Docker image with RDP server using xrdp⁠ on Ubuntu with Xfce⁠.

Images are built weekly using Ubuntu 24.04 (noble).

⁠Getting Started

Run with an interactive bash session testing:

docker run -it \
    --rm \
    --hostname="$(hostname)" \
    --publish="3389:3389/tcp" \
    --name="remote-desktop" \
    scottyhardy/docker-remote-desktop:latest /bin/bash

Start as a detached daemon:

docker run --detach \
    --rm \
    --hostname="$(hostname)" \
    --publish="3389:3389/tcp" \
    --name="remote-desktop" \
    scottyhardy/docker-remote-desktop:latest

Stop the detached container:

docker kill remote-desktop

Download the latest version of the image:

docker pull scottyhardy/docker-remote-desktop

⁠Connecting with an RDP client

All Windows desktops and servers come with Remote Desktop pre-installed and macOS users can download the Microsoft Remote Desktop application for free from the App Store. For Linux users, I'd suggest using the Remmina Remote Desktop client.

For the hostname, use localhost if the container is hosted on the same machine you're running your Remote Desktop client on and for remote connections just use the name or IP address of the machine you are connecting to. NOTE: To connect to a remote machine, it will require TCP port 3389 to be exposed through the firewall.

To log in, use the following default user account details:

Username: ubuntu
Password: ubuntu

⁠Building docker-remote-desktop

Clone the GitHub repository:

git clone https://github.com/scottyhardy/docker-remote-desktop.git
cd docker-remote-desktop

Build the image with the supplied script:

./build

Or run the following docker command:

docker build -t docker-remote-desktop .