All Projects → accetto → ubuntu-vnc-xfce-chromium

accetto / ubuntu-vnc-xfce-chromium

Licence: Apache-2.0 license
Retired. Headless Ubuntu/Xfce container with VNC/noVNC and Chromium (Generation 1)

Programming Languages

Dockerfile
14818 projects

Projects that are alternatives of or similar to ubuntu-vnc-xfce-chromium

ubuntu-vnc-xfce
Headless Ubuntu/Xfce containers with VNC/noVNC (Generation 1)
Stars: ✭ 51 (+155%)
Mutual labels:  virtual-machine, headless, container, desktop, novnc, vnc, headless-browsers, tigervnc, container-station, accetto
ubuntu-vnc-xfce-firefox
Retired. Headless Ubuntu/Xfce containers with VNC/noVNC and Firefox (Generation 1)
Stars: ✭ 20 (+0%)
Mutual labels:  virtual-machine, headless, container, novnc, vnc, headless-browsers, tigervnc, container-station, accetto
ubuntu-vnc-xfce-g3
Headless Ubuntu/Xfce containers with VNC/noVNC (Generation 3)
Stars: ✭ 83 (+315%)
Mutual labels:  headless, desktop, chromium, novnc, vnc, tigervnc, accetto
soulseek-docker
🐳 Soulseek Over noVNC Docker Container
Stars: ✭ 149 (+645%)
Mutual labels:  container, novnc, vnc, tigervnc
headless-chrome-alpine
A Docker container running headless Chrome
Stars: ✭ 26 (+30%)
Mutual labels:  headless, chromium, headless-browsers
Runtime
OCI (Open Containers Initiative) compatible runtime using Virtual Machines
Stars: ✭ 588 (+2840%)
Mutual labels:  virtual-machine, container
Ring
Innovative and practical general-purpose multi-paradigm language
Stars: ✭ 716 (+3480%)
Mutual labels:  virtual-machine, desktop
Simple
The Simple Intelligent and Modular Programming Language and Environment
Stars: ✭ 120 (+500%)
Mutual labels:  virtual-machine, desktop
Emupedia.github.io
The purpose of Emupedia is to serve as a nonprofit meta-resource, hub and community for those interested mainly in video game preservation which aims to digitally collect, archive and preserve games and software to make them available online accessible by a user-friendly UI that simulates several retro operating systems for educational purposes.
Stars: ✭ 206 (+930%)
Mutual labels:  virtual-machine, desktop
Taiko
A node.js library for testing modern web applications
Stars: ✭ 2,964 (+14720%)
Mutual labels:  headless, headless-browsers
Core
Eru, a simple, stateless, flexible, production-ready orchestrator designed to easily integrate into existing workflows. Can run any virtualization things in long or short time.
Stars: ✭ 147 (+635%)
Mutual labels:  virtual-machine, container
chrome-headless-launcher
Run the latest Chrome browser on CLI without head
Stars: ✭ 39 (+95%)
Mutual labels:  headless, chromium
Cc Oci Runtime
OCI (Open Containers Initiative) compatible runtime for Intel® Architecture
Stars: ✭ 418 (+1990%)
Mutual labels:  virtual-machine, container
Multipass
Multipass orchestrates virtual Ubuntu instances
Stars: ✭ 3,978 (+19790%)
Mutual labels:  virtual-machine, container
Dockerpi
A Virtualised Raspberry Pi inside a Docker image
Stars: ✭ 1,064 (+5220%)
Mutual labels:  virtual-machine, container
Runtime
Kata Containers version 1.x runtime (for version 2.x see https://github.com/kata-containers/kata-containers).
Stars: ✭ 2,103 (+10415%)
Mutual labels:  virtual-machine, container
Google Meet Scheduler
😴 Attends classes for you.
Stars: ✭ 150 (+650%)
Mutual labels:  headless, chromium
Pdf Bot
🤖 A Node queue API for generating PDFs using headless Chrome. Comes with a CLI, S3 storage and webhooks for notifying subscribers about generated PDFs
Stars: ✭ 2,551 (+12655%)
Mutual labels:  headless, chromium
CrawlerSamples
This is a Puppeteer+AngleSharp crawler console app samples, used C# 7.1 coding and dotnet core build.
Stars: ✭ 36 (+80%)
Mutual labels:  headless, headless-browsers
docker-chromium
Docker container with Chromium desktop and a Web VNC client allowing you to run Chromium on any server you have
Stars: ✭ 64 (+220%)
Mutual labels:  chromium, vnc

Headless Ubuntu/Xfce container with VNC/noVNC and Chromium

accetto/ubuntu-vnc-xfce-chromium

Docker Hub - Git Hub - Changelog - Wiki


Attention! The repository is retired and archived. It will not be developed any further and the related images on Docker Hub will not be rebuilt any more. They will phase out and they will be deleted after becoming too old. Please use the newer third generation (G3) repository accetto/ubuntu-vnc-xfce-g3 and the related images on Docker Hub instead. If you still need images based on Ubuntu 18.04 LTS, then feel free using the repository for building the images locally.


badge-docker-pulls badge-docker-stars badge-github-release badge-github-release-date badge-github-stars badge-github-forks badge-github-open-issues badge-github-closed-issues badge-github-releases badge-github-commits badge-github-last-commit

Tip If you want newer images based on Ubuntu 20.04 LTS with the latest TigerVNC/noVNC versions, please check the third generation (G3) accetto/ubuntu-vnc-xfce-g3, accetto/ubuntu-vnc-xfce-chromium-g3 or accetto/ubuntu-vnc-xfce-firefox-g3.

Tip Unless you need nss_wrapper, you can also use my newer image accetto/xubuntu-vnc-novnc-chromium, which is a streamlined version of this image (image hierarchy). If you also don't need noVNC, you can use even a slimmer image accetto/xubuntu-vnc-chromium, which is a member of another growing family of application images (image hierarchy). The newer images include also sudo command.

Attention Chromium Browser in this image runs in --no-sandbox mode. You should be aware of the implications. The image is intended for testing and development.


This repository contains resources for building a Docker image based on Ubuntu with Xfce desktop environment, VNC/noVNC servers for headless use and the current Chromium web browser.

The image can be successfully built and used on Linux, Windows, Mac and NAS devices. It has been tested with Docker Desktop on Ubuntu flavours, Windows 10 and Container Station from QNAP.

Containers created from this image make perfect light-weight web browsers. They can be thrown away easily and replaced quickly, improving browsing privacy. They run under a non-root user by default, improving browsing security.

Running in background is the primary scenario for the containers, but using them interactively in foreground is also possible. For examples see the description below or the HOWTO section in Wiki.

The image is based on the accetto/ubuntu-vnc-xfce image, just adding the Chromium web browser.

The image inherits the following components from its base image:

  • utilities ping, wget, zip, unzip, curl, git (Ubuntu distribution)
  • current version of JSON processor jq
  • light-weight Xfce desktop environment (Ubuntu distribution)
  • current version of high-performance TigerVNC server and client
  • current version of noVNC HTML5 clients (full and lite) (TCP port 6901)
  • popular text editors vim and nano (Ubuntu distribution)
  • lite but advanced graphical editor mousepad (Ubuntu distribution)
  • support of version sticker (see below)

The image is regularly maintained and rebuilt. The history of notable changes is documented in CHANGELOG.

screenshot-container

Image set

Ports

Following TCP ports are exposed:

  • 5901 used for access over VNC
  • 6901 used for access over noVNC

The default VNC user password is headless.

Volumes

The containers do not create or use any external volumes by default. However, the following folders make good mounting points:

  • /home/headless/Documents/
  • /home/headless/Downloads/
  • /home/headless/Music/
  • /home/headless/Pictures/
  • /home/headless/Public/
  • /home/headless/Templates/
  • /home/headless/Videos/

The following mounting point is specific to Chromium:

  • /home/headless/.cache/chromium/

Both named volumes and bind mounts can be used. More about volumes can be found in Docker documentation (e.g. Manage data in Docker).

Version sticker

Version sticker serves multiple purposes that are closer described in Wiki. The version sticker value identifies the version of the docker image and it is persisted in it when it is built. It is also shown as a badge in the README file.

However, the script version_sticker.sh can be used anytime for convenient checking of the current versions of installed applications.

The script is deployed into the startup folder, which is defined by the environment variable STARTUPDIR with the default value of /dockerstartup.

If the script is executed inside a container without an argument, then it returns the current version sticker value of the container. This value is newly calculated and it is based on the current versions of the essential applications in the container.

The current version sticker value will differ from the persisted value, if any of the included application has been updated to another version.

If the script is called with the argument -v (lower case v), then it prints out verbose versions of the essential applications that are included in the version sticker value.

If it is called with the argument -V (upper case v), then it prints out verbose versions of some more applications.

Examples can be found in Wiki.

Running containers in background (detached)

Created containers will run under the non-root user headless:headless by default.

The following container will listen on automatically selected TCP ports of the host computer:

docker run -d -P accetto/ubuntu-vnc-xfce-chromium

The following container will listen on the host's explicit TCP ports 25901 (VNC) and 26901 (noVNC):

docker run -d -p 25901:5901 -p 26901:6901 accetto/ubuntu-vnc-xfce-chromium

The following container wil create or re-use the local named volume my_Downloads mounted as /home/headless/Downloads. The container will be accessible through the same TCP ports as the one above:

docker run -d -P -v my_Downloads:/home/headless/Downloads accetto/ubuntu-vnc-xfce-chromium

or using the newer syntax with --mount flag:

docker run -d -P --mount source=my_Downloads,target=/home/headless/Downloads accetto/ubuntu-vnc-xfce-chromium

More usage examples can be found in Wiki (section HOWTO).

Running containers in foreground (interactively)

The image supports the following container start-up options: --wait (default), --skip, --debug (also --tail-log) and --help. This functionality is inherited from the base image.

The following container will print out the help and then it'll remove itself:

docker run --rm accetto/ubuntu-vnc-xfce-chromium --help

Excerpt from the output, which describes the other options:

OPTIONS:
-w, --wait      (default) Keeps the UI and the vnc server up until SIGINT or SIGTERM are received.
                An optional command can be executed after the vnc starts up.
                example: docker run -d -P accetto/ubuntu-vnc-xfce
                example: docker run -it -P --rm accetto/ubuntu-vnc-xfce bash

-s, --skip      Skips the vnc startup and just executes the provided command.
                example: docker run -it -P --rm accetto/ubuntu-vnc-xfce --skip echo $BASH_VERSION

-d, --debug     Executes the vnc startup and tails the vnc/noVNC logs.
                Any parameters after '--debug' are ignored. CTRL-C stops the container.
                example: docker run -it -P --rm accetto/ubuntu-vnc-xfce --debug

-t, --tail-log  same as '--debug'

-h, --help      Prints out this help.
                example: docker run --rm accetto/ubuntu-vnc-xfce

It should be noticed, that the --debug start-up option does not show the command prompt even if the -it run arguments are provided. This is because the container is watching the incoming vnc/noVNC connections and prints out their logs in real time. However, it is easy to attach to the running container like in the following example.

In the first terminal window on the host computer, create a new container named foo:

docker run --name foo accetto/ubuntu-vnc-xfce-chromium --debug

In the second terminal window on the host computer, execute the shell inside the foo container:

docker exec -it foo /bin/bash

Using headless containers

There are two ways, how to use the created headless containers. Note that the default VNC user password is headless.

Over VNC

To be able to use the containers over VNC, a VNC Viewer is needed (e.g. TigerVNC or TightVNC).

The VNC Viewer should connect to the host running the container, pointing to the host's TCP port mapped to the container's TCP port 5901.

For example, if the container has been created on the host called mynas using the parameters described above, the VNC Viewer should connect to mynas:25901.

Over noVNC

To be able to use the containers over noVNC, an HTML5 capable web browser is needed. It actually means, that any current web browser can be used.

The browser should navigate to the host running the container, pointing to the host's TCP port mapped to the container's TCP port 6901.

However, the containers offer two noVNC clients - lite and full. The connection URL differs slightly in both cases. To make it easier, a simple startup page is implemented.

If the container have been created on the host called mynas using the parameters described above, then the web browser should navigate to http://mynas:26901.

The startup page will show two hyperlinks pointing to the both noVNC clients:

  • http://mynas:26901/vnc_lite.html
  • http://mynas:26901/vnc.html

It's also possible to provide the password through the links:

  • http://mynas:26901/vnc_lite.html?password=headless
  • http://mynas:26901/vnc.html?password=headless

Issues

If you have found a problem or you just have a question, please check the Issues and the Troubleshooting, FAQ and HOWTO sections in Wiki first. Please do not overlook the closed issues.

If you do not find a solution, you can file a new issue. The better you describe the problem, the bigger the chance it'll be solved soon.

Credits

Credit goes to all the countless people and companies who contribute to open source community and make so many dreamy things real.


Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].