Chromium
Open-source Chromium web browser in a remote desktop session
Chromium is the open-source web browser project behind Chrome, streamed here in a remote desktop session and backed by remote compute. It builds on the Void Desktop image — Chromium launches maximized with the window decorations and taskbar hidden, so the browser fills the screen.
Configuration
name: chromium
tags:
- desktop
steps:
- name: app
platform: docker
mode: parallel
image: ghcr.io/dxflow-ai/chromium:latest
volumes:
- name: volume
host: ./volume
container: /volume
ports:
- name: web
host: "6082"
container: "6082"
- name: vnc
host: "5901"
container: "5901"
- name: audio
host: "6100"
container: "6100"
env:
- VNC_PASSWORD=changeme
- WALLPAPER=show
- PANEL=hide
- TASKBAR=hide
- AUDIO=off
- AUDIO_PORT=6100
- AUDIO_CHANNELS=1
- AUDIO_RATE=22050
resources:
cpu: "2"
memory: 4G
[volume]
app.volume = ./volume
[port]
app.web = 6082
app.vnc = 5901
app.audio = 6100
[env]
app.VNC_PASSWORD = changeme
app.WALLPAPER = show
app.PANEL = hide
app.TASKBAR = hide
app.AUDIO = off
app.AUDIO_PORT = 6100
app.AUDIO_CHANNELS = 1
app.AUDIO_RATE = 22050
[resource]
app.cpu = 2
app.memory = 4G
{
"arch": ["amd64", "arm64"],
"image": "ghcr.io/dxflow-ai/chromium:latest",
"version": "132.0",
"minimum": {
"cpu": 2,
"memory": "2G",
"storage": "20G"
}
}
Usage
1. Deploy
dxflow workflow create --identity chromium chromium.yml
# Start with defaults, or tune per run with --override
dxflow workflow start chromium
dxflow workflow start chromium \
--override env.app.VNC_PASSWORD=my-strong-pass \
--override env.app.TASKBAR=show
2. Open the browser
Open your browser at http://localhost:6082/vnc.html and enter the password you set in VNC_PASSWORD. Chromium is already running and maximized. Port 5901 is also exposed for connecting a native VNC client.
3. Persist data
The browser profile lives under /volume, so history, cookies, and signed-in sessions survive restarts — mount a local directory there to keep your data.
Notes
- Set a strong
VNC_PASSWORD; if unset, the desktop falls back to the passwordanonymous. - Chromium runs with
--no-sandboxbecause it runs as root inside the container. Keep the session private and protected byVNC_PASSWORD. - The panel and taskbar are hidden by default so the browser fills the screen. Set
PANEL=showorTASKBAR=showto bring back the window decorations and taskbar. - Audio: off by default. Set
AUDIO=onto stream browser sound; tune withAUDIO_CHANNELS(1 or 2) andAUDIO_RATE(8000/16000/22050/32000/44100). The audio port isAUDIO_PORT(default6100) — the client follows it, so to run two sessions on one host give each its own port by settingAUDIO_PORTand the matchingaudioport mapping together.