crvd

crvd

Docker app from googleg's Repository

Overview

This provides a lightweight Linux virtual desktop environment that is accessible using Chrome Remote Desktop. Therefore, accessing the virtual desktop does not require any port redirection on your router and benefits from the identity protection provided by Google (including multi-factor authentication). Video playback with sound (e.g. yt videos) is fully supported. The container is based on Ubuntu 24.04 LTS (Noble Numbat) and contains the XFCE Desktop Environment, Chrome Remote Desktop, and the Firefox browser among others. Additional applications can be installed using apt package manager. Credits given to @cardinalby for the original Dockerfile.

Ubuntu + Chrome Remote Desktop + Firefox docker image

This image is based on Ubuntu and contains XFCE Desktop Environment, Chrome Remote Desktop and Firefox browser.

It enables you to connect to the container via Chrome Remote Desktop and have desktop environment with web browsing inside the container even if you can't connect to your container directly (for example, your container us running behind NAT).

Env variables

  • HOSTNAME (optional, default: myvirtualdesktop). The name your host will be shown under in "Remote devices" list on Chrome Remote Desktop website.
  • CODE (required). Authorization code generated by Chrome Remote Desktop.
  • PIN (optional, default: 123456). PIN code that you can come up with. It will be requested when you try to connect to a container via Chrome Remote Desktop.

Why would I want it?

The image was created for Synology NAS users. It's a common case when NAS is running behind ISP NAT and users can't directly access it outside their local network, but they still are able to access NAS via Synology Quick Connect and start Docker container.

Chrome Remote Desktop also uses outgoing connection to Google servers, enabling users to connect to the container and browse local network or Internet from their home IP address.

The more proper option (but more tricky in setting up) is using VPN on your NAS + ZeroTier container to get around the problem of ISP NAT.

Synology DSM 6,7 instructions

  • Install "Docker" package on your NAS and open it's UI.
  • Open "Registry" tab. Search for cardinalby chrome-remote-desktop image and "Download" it. Downloading cardinalby/chrome-remote-desktop image.
  • After the image is downloaded, open "Images" tab select the image and click "Launch" Launching the image.
  • In the dialog window that opens click "Advanced Settings" Create Container window.
  • In "Advanced Settings" window open "Environment" tab and change the default PIN (optional). Advanced Settings window. Leave the window and a browser tab opened, we will return here soon.
  • Next we are going to obtain an authorization code needed to start the container. Since the code expires in a short time, do it quickly.
  • Open https://remotedesktop.google.com/headless in a new browser tab. Click "Begin", then "Next", then "Authorize" Chrome Remote Desktop setup dialog.
  • You will see the instructions for different OS. All we need is the long code consisting of digits + letters that is placed inside the quotes in command: code="4/xxx". Copy it to the clipboard, click "Start over" Chrome Remote Desktop setup dialog.
  • Get back to Synology DSM tab and insert the code as a value for corresponding env variable. Click "Apply". Advanced Settings window.
  • Click "Next" in "Create Container" dialog Create Container dialog.
  • Ensure that "Run this container after the wizzard is finished" checkbox is set and click "Apply" Create Container dialog.
  • Wait until container starts and get back to "Chrome Remote Desktop" website. Go to "Remote Access" tab (at the left) and wait for a new machine appears in the list of remote devices. Click on it. Remote Access tab.
  • In the dialog enter the PIN (123456 if you didn't change the default one) and click blue arrow button. PIN dialog.
  • You should see the XFCE desktop environment of your Ubuntu Linux. You can launch Firefox browser from "Applications" - "Internet" menu. PIN dialog.

Install Crvd on Unraid in a few clicks.

Find Crvd in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Crvd Review the template variables and paths Click Install

Download Statistics

1,398
Total Downloads

Related apps

Explore more like this

Explore all

Details

Repository
googleg/chrome-remote-desktop-vdi
Last Updated2025-08-01
First Seen2025-06-11

Runtime arguments

Network
bridge
Privileged
false
Extra Params
--restart unless-stopped

Template configuration

Host nameVariable

The name your host will be shown in Remote devices list on Chrome Remote Desktop website or application.

Target
HOSTNAME
Default
myvirtualdesktop
Authorization codeVariable

Authorization code generated by Chrome Remote Desktop. This code is single-use only! If you rebuild your container without savings your files (see home directory under advanced settings), you will need to provide a new code.

Target
CODE
Default
4/xx
PIN codeVariable

PIN code that you can come up with. It will be requested when you try to connect to a container via Chrome Remote Desktop.

Target
PIN
Default
123456
Home directoryPathrw

Container path for the persistent files. Mounting this volume allows you to easily access files, documents, and configurations created within the remote desktop session. It is also used to preserve the Chrome Remote Desktop session file across container rebuilds so that there is no need to provide a new token code.

Target
/home/crduser
Default
/mnt/user/appdata/crvd/