release 19.10

CHANGELOG.md

@@ -6,11 +6,18 @@
 
 ***
 
+### Release 19.10
+
+- **xubuntu-vnc-novnc-chromium**
+  - **Chromium Browser** updated to version **77.0.3865.90**
+- **xubuntu-vnc-novnc-firefox**
+  - initial image with **Firefox Quantum** version **69.0.1**
+
 ### Release 19.09
 
-- **xubuntu-vnc**
+- **xubuntu-vnc-novnc**
   - initial image with **Ubuntu 18.04.3 LTS**
-- **xubuntu-vnc-chromium**
+- **xubuntu-vnc-novnc-chromium**
   - initial image with **Chromium Browser** version **76.0.3809.100**
 
 ***

README.md

@@ -28,6 +28,14 @@ Additional components and applications can be easily added by the user because *
 
 Contains resources for building [accetto/xubuntu-vnc-novnc-chromium][this-docker-xubuntu-vnc-novnc-chromium] images with the open-source [Chromium][chromium] web browser.
 
+#### [xubuntu-vnc-novnc-firefox][this-github-xubuntu-vnc-novnc-firefox]
+
+Contains resources for building [accetto/xubuntu-vnc-novnc-firefox][this-docker-xubuntu-vnc-novnc-firefox] images with the current [Firefox Quantum][firefox] web browser.
+
+Several variations are available, including the one supporting easy pre-configuration and copying of personal Firefox user preferences.
+
+The images are streamlined and simplified versions of my other images [accetto/ubuntu-vnc-xfce-firefox-plus][accetto-docker-ubuntu-vnc-xfce-firefox-plus] and [accetto/ubuntu-vnc-xfce-firefox-default][accetto-docker-ubuntu-vnc-xfce-firefox-default].
+
 #### [utils][this-github-utils]
 
 Contains utilities that make building the images more convenient.

docker/xubuntu-vnc-novnc-chromium/hooks/env

@@ -7,7 +7,7 @@ DOCKER_REPO=${DOCKER_REPO:-accetto/xubuntu-vnc-novnc-chromium}
 
 TODAY=$(date +%Y-%m-%d)
 BASETAG=""
-VERSION_STICKER="ubuntu18.04.3-chromium76.0.3809.100"
+VERSION_STICKER="ubuntu18.04.3-chromium77.0.3865.90"
 
 case "$DOCKER_TAG" in
 

docker/xubuntu-vnc-novnc-firefox/Dockerfile.firefox

@@ -0,0 +1,66 @@
+# ./hooks/build dev
+# ./hooks/build dfw
+
+ARG BASETAG=latest
+
+FROM accetto/xubuntu-vnc-novnc:${BASETAG} as stage-firefox
+
+### Switch to root user before install
+USER 0
+
+### 'apt-get clean' runs automatically
+RUN apt-get update && apt-get install -y \
+        firefox \
+    && apt-get -y autoremove \
+    && rm -rf /var/lib/apt/lists/*
+
+### Alternatively install an explicit Firefox version
+### http://releases.mozilla.org/pub/firefox/releases/67.0.4/linux-x86_64/en-US/firefox-67.0.4.tar.bz2
+# ENV \
+#     FIREFOX_VERSION=67.0.4 \
+#     FIREFOX_DISTRO=linux-x86_64 \
+#     FIREFOX_PATH=/usr/lib/firefox
+# RUN mkdir -p ${FIREFOX_PATH} \
+#     && wget -qO- http://releases.mozilla.org/pub/firefox/releases/${FIREFOX_VERSION}/${FIREFOX_DISTRO}/en-US/firefox-${FIREFOX_VERSION}.tar.bz2 \
+#         | tar xvj -C /usr/lib/ \
+#     && ln -s ${FIREFOX_PATH}/firefox /usr/bin/firefox
+
+### Preconfigure Xfce
+COPY [ "./src/firefox/home/Desktop", "${HOME}/Desktop/" ]
+COPY [ "./src/firefox/home/config/xfce4", "${HOME}/.config/xfce4/" ]
+COPY [ "./src/startup/version_sticker.sh", "${STARTUPDIR}/" ]
+
+FROM stage-firefox as stage-plus
+
+ARG ARG_MOZ_FORCE_DISABLE_E10S
+
+RUN mkdir ${HOME}/firefox.plus
+
+COPY [ "./src/firefox.plus/resources", "${HOME}/firefox.plus" ]
+COPY [ "./src/firefox.plus/resources/*.svg", "/usr/share/icons/hicolor/scalable/apps/"]
+COPY [ "./src/firefox.plus/home/Desktop", "${HOME}/Desktop/" ]
+
+### Firefox multi-process causes a lot of "Gah. Your tab just crashed."
+### The only way to disable it since Firefox v68.0 is through this environment variable.
+ENV MOZ_FORCE_DISABLE_E10S=${ARG_MOZ_FORCE_DISABLE_E10S:+1}
+
+RUN \
+    chmod +x ${HOME}/firefox.plus/*.sh \
+    && gtk-update-icon-cache -f /usr/share/icons/hicolor
+
+### Fix permissions
+RUN \
+    chmod a+wx "${STARTUPDIR}"/version_sticker.sh \
+    && "${STARTUPDIR}"/set_user_permissions.sh "${STARTUPDIR}" "${HOME}"
+
+FROM stage-plus as stage-final
+
+ARG ARG_REFRESHED_AT
+ARG ARG_VERSION_STICKER
+
+ENV \
+    REFRESHED_AT=${ARG_REFRESHED_AT} \
+    VERSION_STICKER=${ARG_VERSION_STICKER}
+
+### Switch to default application user (non-root)
+USER 1001

docker/xubuntu-vnc-novnc-firefox/Dockerfile.firefox.default

@@ -0,0 +1,54 @@
+# ./hooks/build dev
+# ./hooks/build dfw
+
+ARG BASETAG=latest
+
+FROM accetto/xubuntu-vnc-novnc:${BASETAG} as stage-firefox
+
+ARG ARG_MOZ_FORCE_DISABLE_E10S
+
+### Switch to root user before install
+USER 0
+
+### 'apt-get clean' runs automatically
+RUN apt-get update && apt-get install -y \
+        firefox \
+    && apt-get -y autoremove \
+    && rm -rf /var/lib/apt/lists/*
+
+### Alternatively install an explicit Firefox version
+### http://releases.mozilla.org/pub/firefox/releases/67.0.4/linux-x86_64/en-US/firefox-67.0.4.tar.bz2
+# ENV \
+#     FIREFOX_VERSION=67.0.4 \
+#     FIREFOX_DISTRO=linux-x86_64 \
+#     FIREFOX_PATH=/usr/lib/firefox
+# RUN mkdir -p ${FIREFOX_PATH} \
+#     && wget -qO- http://releases.mozilla.org/pub/firefox/releases/${FIREFOX_VERSION}/${FIREFOX_DISTRO}/en-US/firefox-${FIREFOX_VERSION}.tar.bz2 \
+#         | tar xvj -C /usr/lib/ \
+#     && ln -s ${FIREFOX_PATH}/firefox /usr/bin/firefox
+
+### Preconfigure Xfce
+COPY [ "./src/firefox/home/Desktop", "${HOME}/Desktop/" ]
+COPY [ "./src/firefox/home/config/xfce4", "${HOME}/.config/xfce4/" ]
+COPY [ "./src/startup/version_sticker.sh", "${STARTUPDIR}/" ]
+
+### Firefox multi-process causes a lot of "Gah. Your tab just crashed."
+### The only way to disable it since Firefox v68.0 is through this environment variable.
+ENV MOZ_FORCE_DISABLE_E10S=${ARG_MOZ_FORCE_DISABLE_E10S:+1}
+
+### Fix permissions
+RUN \
+    chmod a+wx "${STARTUPDIR}"/version_sticker.sh \
+    && "${STARTUPDIR}"/set_user_permissions.sh "${STARTUPDIR}" "${HOME}"
+
+FROM stage-firefox as stage-final
+
+ARG ARG_REFRESHED_AT
+ARG ARG_VERSION_STICKER
+
+ENV \
+    REFRESHED_AT=${ARG_REFRESHED_AT} \
+    VERSION_STICKER=${ARG_VERSION_STICKER}
+
+### Switch to default application user (non-root)
+USER 1001

docker/xubuntu-vnc-novnc-firefox/Dockerfile.firefox.myown

@@ -0,0 +1,13 @@
+# docker build -f Dockerfile.firefox.plus -t accetto/xubuntu-vnc-firefox:myown .
+
+ARG BASETAG=latest
+
+FROM accetto/xubuntu-vnc-novnc-firefox:${BASETAG}
+
+USER 0
+
+COPY [ "./src/firefox.plus/resources/user.js", "${HOME}/firefox.plus/user.js" ]
+
+RUN "${STARTUPDIR}"/set_user_permissions.sh "${HOME}/firefox.plus"
+
+USER 1001

docker/xubuntu-vnc-novnc-firefox/README.md

@@ -0,0 +1,190 @@
+# Headless Ubuntu/Xfce container with VNC/noVNC and Firefox
+
+## accetto/xubuntu-vnc-novnc-firefox
+
+[Docker Hub][this-docker] - [Git Hub][this-github] - [Changelog][this-changelog] - [Wiki][this-wiki] - [Hierarchy][this-wiki-image-hierarchy]
+
+***
+
+This repository contains resources for building Docker images based on [Ubuntu][docker-ubuntu] with [Xfce][xfce] desktop environment, [VNC][tigervnc]/[noVNC][novnc] servers for headless use and the current [Firefox Quantum][firefox] web browser.
+
+The main image is a streamlined and simplified version of my other image [accetto/ubuntu-vnc-xfce-firefox-plus][accetto-docker-ubuntu-vnc-xfce-firefox-plus]. The applicable **plus** features have been re-implemented because **Firefox v67** handles user profiles differently.
+
+The images are part of the growing [image hierarchy][this-wiki-image-hierarchy] and they are based on [accetto/xubuntu-vnc-novnc][accetto-docker-xubuntu-vnc-novnc]. They inherit all the features and therefore not the whole description will be repeated here.
+
+The `latest` image inherits among others
+
+- utilities **ping**, **zip**, **unzip**, **sudo**
+- popular text editor [vim][vim]
+- lite but advanced graphical editor [mousepad][mousepad]
+- [tini][tini] as the entry-point initial process (PID 1)
+
+and adds
+
+- [Firefox Quantum][firefox] web browser and some additional **plus** features described below
+
+The history of notable changes is documented in the [CHANGELOG][this-changelog].
+
+![container-screenshot][this-screenshot-container]
+
+### Image tags
+
+The following image tags are regularly maintained and rebuilt:
+
+- `latest` is based on `accetto/xubuntu-vnc-novnc:latest`, it includes the **plus** features and it is built with the build argument **ARG_MOZ_FORCE_DISABLE_E10S**, so the Firefox multiprocess is **disabled** (see below)
+
+    [![version badge](https://images.microbadger.com/badges/version/accetto/xubuntu-vnc-novnc-firefox:latest.svg)](https://microbadger.com/images/accetto/xubuntu-vnc-novnc-firefox:latest "Get your own version badge on microbadger.com") [![size badge](https://images.microbadger.com/badges/image/accetto/xubuntu-vnc-novnc-firefox:latest.svg)](https://microbadger.com/images/accetto/xubuntu-vnc-novnc-firefox:latest "Get your own image badge on microbadger.com")
+
+- `default` is similar to `latest`, but it doesn't include the **plus** features  
+
+    [![version badge](https://images.microbadger.com/badges/version/accetto/xubuntu-vnc-novnc-firefox:default.svg)](https://microbadger.com/images/accetto/xubuntu-vnc-novnc-firefox:default "Get your own version badge on microbadger.com") [![size badge](https://images.microbadger.com/badges/image/accetto/xubuntu-vnc-novnc-firefox:default.svg)](https://microbadger.com/images/accetto/xubuntu-vnc-novnc-firefox:default "Get your own image badge on microbadger.com")
+
+- `multiprocess` is also similar to `latest`, but it is not built with the build argument **ARG_MOZ_FORCE_DISABLE_E10S**, so the Firefox multiprocess is **enabled**  
+
+    [![version badge](https://images.microbadger.com/badges/version/accetto/xubuntu-vnc-novnc-firefox:multiprocess.svg)](https://microbadger.com/images/accetto/xubuntu-vnc-novnc-firefox:multiprocess "Get your own version badge on microbadger.com") [![size badge](https://images.microbadger.com/badges/image/accetto/xubuntu-vnc-novnc-firefox:multiprocess.svg)](https://microbadger.com/images/accetto/xubuntu-vnc-novnc-firefox:multiprocess "Get your own image badge on microbadger.com")
+
+### Dockerfiles
+
+The [Git Hub][this-github-xubuntu-vnc-novnc-firefox] repository contains several Dockerfiles that can be used to build the images.
+
+- `Dockerfile.firefox`  
+
+  This is the main Dockerfile for building the `latest` image tag based on the `accetto/xubuntu-vnc-novnc:latest` tag by default.
+
+  However, by providing the `BASETAG` build argument it is possible to build images based on other base tags, for example `accetto/xubuntu-vnc-novnc:lab`.
+
+  This Docker file will include also the **plus** features described below.
+
+- `Dockerfile.firefox.default`  
+
+  This Dockerfile is for building the `default` image tag, which is also based on the `accetto/xubuntu-vnc-novnc:latest`, but it does not include the **plus** features.
+
+- `Dockerfile.firefox.myown` can be used for building images with own Firefox preferences
+
+### Ports
+
+Following **TCP** ports are exposed:
+
+- **5901** used for access over **VNC**
+- **6901** used for access over [noVNC][novnc]
+
+### 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/Pictures/`, `/home/headless/Public/`
+
+Both **named volumes** and **bind mounts** can be used. More about volumes can be found in the [Docker documentation][docker-doc] (e.g. [Manage data in Docker][docker-doc-managing-data]).
+
+### Container user accounts
+
+Containers created from these images run under the non-root **default application user** (headless, 1001:0). However, the **sudo** command allows user elevation. For more description check the base image [accetto/xubuntu-vnc-novnc][accetto-docker-xubuntu-vnc-novnc] or [Wiki][this-wiki].
+
+### Using headless containers
+
+There are two ways, how to use the created headless containers. Please refer to the base image [accetto/xubuntu-vnc-novnc][accetto-docker-xubuntu-vnc-novnc] to learn about them.
+
+Note that the default **VNC user** password is **headless**.
+
+## Firefox multi-process
+
+Firefox multi-process (also known as **Electrolysis** or just **E10S**) causes in Docker container heavy crashing (**Gah. Your tab just crashed.**) and therefore it needs to be disabled.
+
+In Firefox versions till **67.0.4** it could be done by setting the preferences **browser.tabs.remote.autostart** and **browser.tabs.remote.autostart.2** to **false**. However, Mozilla has removed this possibility since the Firefox version **68.0**.
+
+Since than it can be done only by setting the following environment variable:
+
+```bash
+MOZ_FORCE_DISABLE_E10S
+```
+
+Therefore the images tagged `latest` and `default` set this variable to **1** by using the build argument **ARG_MOZ_FORCE_DISABLE_E10S**.
+
+Note that any value will actually disable the multi-process feature, so the both following settings would have the same effect:
+
+```bash
+MOZ_FORCE_DISABLE_E10S=1
+MOZ_FORCE_DISABLE_E10S=0
+```
+
+Building an image without the build argument **ARG_MOZ_FORCE_DISABLE_E10S** enables the Firefox multi-process feature. The image tagged `multiprocess` is built that way.
+
+To check whether the Firefox multi-process is enabled or disabled, navigate the web browser to the following URL:
+
+```bash
+about:support
+```
+
+## Firefox preferences and the plus features
+
+**Firefox** browser supports pre-configuration of user preferences.
+
+Users can enforce their personal browser preferences if they put them into the `user.js` file and then copy it into the Firefox profile folder. The provided **plus** features make it really easy.
+
+There is the `/home/headless/firefox.plus` folder containing the `user.js` file and the helper utility `copy_firefox_user_preferences.sh`. It will copy the `user.js` file into one or more existing Firefox profiles. The utility is easy to use, because it is interactive and it will also display the help, if started with the `-h` or `--help` argument.
+
+To make it even more convenient, there are also desktop launchers for the utility and for the **Firefox Profile Manager**.
+
+Recommended procedure for taking advantage of the **plus** features is:
+
+- Start the **Firefox Profile Manager** using the desktop launcher **FF Profile Manager**. Create a new Firefox profile if there is none or you want to add one more. Wait until the profile is created and then start Firefox with it. Starting Firefox is required to create the actual profile content.
+
+  **Hint**: You can also check the **Work offline** check-box before creating the profile.
+
+  The Firefox profiles are created inside the `/home/headless/.mozilla/firefox` folder by default. Note that the `.mozilla` folder is hidden.
+
+  Close the **Profile Manager** by pushing the **Exit** button.
+
+- Put your personal Firefox preferences into the `user.js` file which is in the `/home/headless/firefox.plus`folder. Check the Firefox documentation (e.g. [Firefox preferences][firefox-doc-preferences]) for more information about the syntax.  
+
+  **Hint**: There is also another way. You can first start Firefox, configure it and then copy the content of the `prefs.js` file from the Firefox profile folder into the `user.js` file. Then you can check the content and to keep only the preferences you really want to enforce. It's not a quick task, but you have to do it only once or until you need an update.
+
+- Start the helper utility using the desktop launcher **Copy FF Preferences**. The utility will allow you to copy the `user.js` file to any of the existing Firefox profiles.  
+
+  **Hint**: You preferences will be enforced until you delete the `user.js` file from the Firefox profile folder.
+
+It is also very easy to build customized images with pre-filled `user.js` files. The provided `Dockerfile.firefox.myown` show how to do it. The build will take just seconds.
+
+## Issues
+
+If you have found a problem or you just have a question, please check the [Issues][this-issues] and the [Wiki][this-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.
+
+***
+
+[this-docker]: https://hub.docker.com/r/accetto/xubuntu-vnc-novnc-firefox/
+
+[this-github]: https://github.com/accetto/xubuntu-vnc-novnc/
+[this-changelog]: https://github.com/accetto/xubuntu-vnc-novnc/blob/master/CHANGELOG.md
+
+[this-wiki]: https://github.com/accetto/xubuntu-vnc-novnc/wiki
+[this-wiki-image-hierarchy]: https://github.com/accetto/xubuntu-vnc-novnc/wiki/Image-hierarchy
+
+[this-issues]: https://github.com/accetto/xubuntu-vnc-novnc/issues
+
+[this-github-xubuntu-vnc-novnc-firefox]: https://github.com/accetto/xubuntu-vnc-novnc/tree/master/docker/xubuntu-vnc-novnc-firefox
+
+[this-screenshot-container]: https://raw.githubusercontent.com/accetto/xubuntu-vnc-novnc/master/docker/xubuntu-vnc-novnc-firefox/xubuntu-vnc-novnc-firefox.jpg
+
+[accetto-docker-xubuntu-vnc-novnc]: https://hub.docker.com/r/accetto/xubuntu-vnc-novnc/
+[accetto-docker-ubuntu-vnc-xfce-firefox-plus]: https://hub.docker.com/r/accetto/ubuntu-vnc-xfce-firefox-plus/
+
+[docker-ubuntu]: https://hub.docker.com/_/ubuntu/
+
+[docker-doc]: https://docs.docker.com/
+[docker-doc-managing-data]: https://docs.docker.com/storage/
+
+[firefox-doc-preferences]: https://developer.mozilla.org/en-US/docs/Mozilla/Preferences/A_brief_guide_to_Mozilla_preferences
+
+[mousepad]: https://github.com/codebrainz/mousepad
+[novnc]: https://github.com/kanaka/noVNC
+[tigervnc]: http://tigervnc.org
+[tightvnc]: http://www.tightvnc.com
+[tini]: https://github.com/krallin/tini
+[vim]: https://www.vim.org/
+[xfce]: http://www.xfce.org
+
+[firefox]: https://www.mozilla.org

docker/xubuntu-vnc-novnc-firefox/hooks/build

@@ -0,0 +1,16 @@
+#!/bin/bash -xe
+
+. ./hooks/env
+
+if [[ -n "$BASETAG" ]] ; then
+
+    docker build \
+        -f $DOCKERFILE_PATH \
+            --build-arg BASETAG="$BASETAG" \
+            --build-arg ARG_REFRESHED_AT="$TODAY" \
+            --build-arg ARG_VERSION_STICKER="$VERSION_STICKER" \
+            ${IS_SINGLEPROCESS_BUILD:+--build-arg ARG_MOZ_FORCE_DISABLE_E10S=yes} \
+        -t $DOCKER_REPO:$DOCKER_TAG .
+else
+    echo "Build request not recognized: $SOURCE_BRANCH"
+fi