Skip to content

Latest commit

 

History

History
124 lines (81 loc) · 4.25 KB

README.md

File metadata and controls

124 lines (81 loc) · 4.25 KB
Raw

This project is fully inspired of sameersbn Skype's containerization.

mdouchement/zoom-us

Introduction

Dockerfile to create a Docker container image with Zoom for Linux with support for audio/video calls.

The image uses X11 and Pulseaudio unix domain sockets on the host to enable audio/video support in Zoom. These components are available out of the box on pretty much any modern linux distribution.

Contributing

If you find this image useful here's how you can help:

  • Send a pull request with your awesome features and bug fixes
  • Help users resolve their issues.

Getting started

Installation

Automated builds of the image are available on Dockerhub and is the recommended method of installation.

docker pull mdouchement/zoom-us:latest

Alternatively you can build the image yourself.

docker build -t mdouchement/zoom-us github.com/mdouchement/docker-zoom-us

With the image locally available, install the wrapper scripts by running the following as root:

docker run -it --rm \
  --volume /usr/local/bin:/target \
  mdouchement/zoom-us:latest install

This will install a wrapper script to launch zoom.

Note

If Zoom is installed on the the host then the host binary is launched instead of starting a Docker container. To force the launch of Zoom in a container use the zoom-us-wrapper script. For example, zoom-us-wrapper zoom will launch Zoom inside a Docker container regardless of whether it is installed on the host or not.

Web Browser / SSO

Add the following option in ~/.config/zoomus.conf

embeddedBrowserForSSOLogin=false

Zoom will spawn Iceweasel (Firefox) included in this image and open SSO provider web page.

How it works

The wrapper scripts volume mount the X11 and pulseaudio sockets in the launcher container. The X11 socket allows for the user interface display on the host, while the pulseaudio socket allows for the audio output to be rendered on the host.

When the image is launched the following directories are mounted as volumes

  • ${HOME}/.zoom
  • ${HOME}/.config
  • XDG_DOWNLOAD_DIR or if it is missing ${HOME}/Downloads
  • XDG_DOCUMENTS_DIR or if it is missing ${HOME}/Documents

This makes sure that your profile details are stored on the host and files received via Zoom are available on your host in the appropriate download directory.

Don't want to expose host's folders to Zoom?

Add ZOOM_HOME environment variable to namespace all Zoom folders:

export ZOOM_HOME=${HOME}/zoomus

Maintenance

Upgrading

To upgrade to newer releases:

  1. Download the updated Docker image:
docker pull mdouchement/zoom-us:latest
  1. Run install to make sure the host scripts are updated.
docker run -it --rm \
  --volume /usr/local/bin:/target \
  mdouchement/zoom-us:latest install

Uninstallation

docker run -it --rm \
  --volume /usr/local/bin:/target \
  mdouchement/zoom-us:latest uninstall

Shell Access

For debugging and maintenance purposes you may want access the containers shell. If you are using Docker version 1.3.0 or higher you can access a running containers shell by starting bash using docker exec:

docker exec -it zoomus bash

Troubleshooting

  • Zoom basic logs: docker logs zoomus
  • Screen sharing:
    • Try xhost +SI:localuser:"$USER" #20
  • Transparent login form:
    • A possible workaround is to right click on the Zoom icon from the taskbar and select "About". The about popup could fix the login form render.
    • If Unrecognized OpenGL version error is in the logs, it could be an issue with Nvidia drivers #1