startx/vdi-firefox repository overview

⁠Docker OS Images : Firefox

Simple container used to server VNC based firefox browser. Run firefox browser application⁠ under a container based on startx/fedora container⁠

⁠Available flavours

• :latest : Fedora core 29 + Firefox 50.0.2661.102
• :fc28 : Fedora core 28 + Firefox 50.0.2661.102
• :centos7 : CentOS 7 + Firefox
• :alpine3 : Alpine 3.7 + Firefox 50.0.2661.102

⁠Running from dockerhub registry

• with docker you can run docker run -it --name="vdi-firefox" startx/vdi-firefox from any docker host
• with docker-compose you can create a docker-compose.yml file with the following content

service:
  image: startx/vdi-firefox:latest
  container_name: "vdi-firefox"
  volumes:
    - "/tmp/container/firefox/logs:/logs:z"
    - "/tmp/container/firefox/data:/home/firefox:z"

⁠Using this image as Openshift Build image

You can use this public image as a base image in your openshift build strategy. You can first import our openshift image stream⁠ and automatically add them in your service catalog. You can also test our deploy template⁠ or our build and deploy template⁠

# import image streams
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/VDI/firefox/openshift-imageStreams.json
# import deploy template and start a sample application
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/VDI/firefox/openshift-template.json
oc process startx-vdi-firefox-template | oc create -f -
# import build and deploy template and start a sample application
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/VDI/firefox/openshift-template-build.json
oc process startx-vdi-firefox-build-template | oc create -f -

⁠Using this image as S2I builder

You can use this image as an s2i builder image.

s2i build https://github.com/startxfr/docker-images-example-firefox startx/vdi-firefox test-firefox
docker run --rm -i -t test-firefox

⁠Docker-compose in various situations

• sample docker-compose.yml linked to host port 1000

service:
  image: startx/vdi-firefox:latest
  container_name: "vdi-firefox"
  ports:
    - "1000:5900"

• sample docker-compose.yml with port exposed only to linked VDI

service:
  image: startx/vdi-firefox:latest
  container_name: "vdi-firefox"
  expose:
    - "5900"

• sample docker-compose.yml using data container

data:
  image: startx/fedora:latest
  container_name: "vdi-firefox-data"
service:
  image: startx/vdi-firefox:latest
  container_name: "vdi-firefox"
  volume_from:
    - data:rw

⁠Using this image as base container

You can use this Dockerfile template to start a new personalized container based on this container. Create a file named Dockerfile in your project directory and copy this content inside. See docker guide⁠ for instructions on how to use this file.

FROM startx/vdi-firefox:latest
#... your container specifications
CMD ["/bin/sx", "run"]

⁠Environment variable

This container is based on startx fedora container⁠ who came with some additional environment variable⁠

⁠Exposed port

⁠Exposed volumes

⁠Testing the desktop application

access to the running Browser with your favorites vnc client vinagre vnc://localhost:5900. Change port and hostname according to your current configuration

⁠For advanced users

You want to use this container and code to build and create locally this container, follow theses instructions.

This section will help you if you want to :

• Get latest version of this desktop container
• Enhance container content by adding instruction in Dockefile before build step

You must have a working environment with the source code of this repository. Read and follow how to setup your working environment⁠ to get a working directory. The following instructions assume you are at the top level of your working directory.

⁠Build & run a container using docker

1. Jump into the container directory with cd VDI/firefox
2. Build the container using docker build -t vdi-firefox .
3. Run this container
4. Interactively with docker run -p 5900:5900 -v /data:/home/firefox -it vdi-firefox. If you add a second parameter (like /bin/bash) to will run this command instead of the default entrypoint. Usefull to interact with this container (ex: /bin/bash, /bin/ps -a, /bin/df -h,...)
5. As a daemon with docker run -p 5900:5900 -v /data:/home/firefox -d vdi-firefox

⁠Build & run a container using docker-compose

1. Jump into the container directory with cd VDI/firefox
2. Run this container
3. Interactively with docker-compose up Startup logs appears and escaping this command stop the container
4. As a daemon with docker-compose up -d. Container startup logs can be read using docker-compose logs

If you experience trouble with port already used, edit docker-compose.yml file and change port mapping