terrorizer1980 / manjaro-xrdp-gnome

GNOME remote desktop Docker image powered by Manjaro and xrdp

GNOME remote desktop Docker image powered by Manjaro and xrdp

This repository provides the Docker image that runs a GNOME desktop on top of Manjaro Linux. The desktop is accessible via RDP (Remote Desktop Protocol) clients such as Remmina, FreeRDP, Microsoft Remote Desktop (for macOS).

Interested in LXQt? See manjaro-xrdp-lxqt.

Step 1: Pull the image

Pull the Docker image from ghcr.io/trustin/manjaro-xrdp-gnome:latest.

docker pull ghcr.io/trustin/manjaro-xrdp-gnome:latest

Step 2: Create a new container from the pulled image

Create a new container like the following. Note that --privileged option is required.

docker create \
  --name manjaro-xrdp-gnome \
  --env "LANG=en_US.UTF-8" \
  --env "TZ=America/Los_Angeles" \
  --env "PUSER=user" \
  --env "PUID=1000" \
  --tty \
  --interactive \
  --privileged \
  --shm-size 2G \
  --publish 23389:3389 \
  --publish 8022:22 \
  ghcr.io/trustin/manjaro-xrdp-gnome:latest

Parameters

Parameter	Example	Function
PUSER	john	The username of the desktop user (default: user)
PUID	1000	The nummeric user ID of the desktop user (default: 1000)
TZ	Asia/Seoul	System timezone (default: America/Los_Angeles)
LANG	en_US.UTF-8	System locale (default: en_US.UTF-8)

Step 3: Start the container.

docker start manjaro-xrdp-gnome

Step 4: Connect to the desktop.

You should now be able to access your full-featured GNOME desktop using the RDP client of your choice. For example, using Remmina:

remmina -c rdp://127.0.0.1:23389

Note that your initial login password is same with your username, which you specified via the PUSER environment variable. It's highly recommended to change your password as soon as possible.

Customizing and building the image

Clone this repository, edit Dockerfile and then run docker build as usual:

docker build --tag 'custom-manjaro-xrdp-gnome:latest' .

Specifying an alternative mirror

US mirrors are used by default to fetch the packages. You can specify the MIRROR_URL build argument to overide:

docker build --tag 'custom-manjaro-xrdp-gnome:latest' \
  --build-arg "MIRROR_URL=https://repo.ialab.dsu.edu/manjaro/" .

Invalidating cache

Use --no-cache option:

docker build --tag 'custom-manjaro-xrdp-gnome:latest' --no-cache .

License

This repository is licensed under Apache License 2.0.