Docker image for Remote Desktop server with audio support
  • Shell 52.4%
  • Dockerfile 47.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Scott Hardy bf80ed6672
Merge pull request #45 from scottyhardy/feature/armhf
feat: add arm/v7 platform to ci builds (#37)
2025-04-05 18:20:33 +11:00
.github feat: add arm/v7 platform to ci builds (#37) 2025-04-05 18:15:41 +11:00
.gitignore chore: add .gitignore 2020-03-27 22:10:17 +11:00
build feat: build and deploy with ubuntu latest, rolling and devel 2020-04-05 19:40:46 +10:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2020-03-28 05:15:02 +11:00
deploy fix: use version not codename 2020-06-11 20:04:39 +10:00
Dockerfile refactor: move copy from builder below package installs 2025-04-05 15:29:36 +11:00
entrypoint.sh fix: check if user exists before creating account 2025-04-04 09:52:44 +11:00
LICENSE Initial commit 2020-03-27 13:31:12 +11:00
README.md feat: use ubuntu 24.04 noble as base 2025-04-04 08:01:07 +11:00
run fix: require increased shared mem to prevent firefox crashing 2020-05-24 17:09:54 +10:00
screenshot_1.png chore: update screenshots 2020-03-29 11:37:35 +11:00
screenshot_2.png chore: update screenshot 2025-04-04 08:07:36 +11:00
start chore: change repo name 2020-03-28 11:42:27 +11:00
stop chore: change repo name 2020-03-28 11:42:27 +11:00

docker-remote-desktop

build GitHub stars GitHub forks Docker Stars Docker Pulls

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:

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

Screenshot of login prompt

Screenshot of XFCE desktop

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 .

Running local images with scripts

I've created some simple scripts that give the minimum requirements for either running the container interactively or running as a detached daemon.

To run with an interactive bash session:

./run

To start as a detached daemon:

./start

To stop the detached container:

./stop