https://github.com/mdouchement/docker-zoom-us
Dockerized zoom with voice and video call support
https://github.com/mdouchement/docker-zoom-us
docker video-conferencing zomm-us
Last synced: 5 months ago
JSON representation
Dockerized zoom with voice and video call support
- Host: GitHub
- URL: https://github.com/mdouchement/docker-zoom-us
- Owner: mdouchement
- License: mit
- Created: 2016-01-29T19:33:10.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-06-28T12:04:57.000Z (over 2 years ago)
- Last Synced: 2025-05-08T00:39:12.051Z (5 months ago)
- Topics: docker, video-conferencing, zomm-us
- Language: Shell
- Size: 22.5 KB
- Stars: 173
- Watchers: 4
- Forks: 47
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This project is fully inspired of [sameersbn](https://github.com/sameersbn) [Skype](https://github.com/sameersbn/docker-skype)'s containerization.
# mdouchement/zoom-us
# Introduction
`Dockerfile` to create a [Docker](https://www.docker.com/) container image with [Zoom](http://www.zoom.us) for Linux with support for audio/video calls.
The image uses [X11](http://www.x.org) and [Pulseaudio](http://www.freedesktop.org/wiki/Software/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](https://github.com/mdouchement/docker-zoom-us/issues?q=is%3Aopen+is%3Aissue).
# Getting started
## Installation
Automated builds of the image are available on [Dockerhub](https://hub.docker.com/r/mdouchement/zoom-us) and is the recommended method of installation.
```bash
docker pull mdouchement/zoom-us:latest
```
Alternatively you can build the image yourself.
```bash
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:
```bash
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:
```sh
export ZOOM_HOME=${HOME}/zoomus
```
# Maintenance
## Upgrading
To upgrade to newer releases:
1. Download the updated Docker image:
```bash
docker pull mdouchement/zoom-us:latest
```
2. Run `install` to make sure the host scripts are updated.
```bash
docker run -it --rm \
--volume /usr/local/bin:/target \
mdouchement/zoom-us:latest install
```
## Uninstallation
```bash
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`:
```bash
docker exec -it zoomus bash
```
## Troubleshooting
- Zoom basic logs:
- `docker logs zoomus`
- `ls -l ${ZOOM_HOME:=$HOME}/.zoom/logs` where you can find application logs.
- Screen sharing:
- Try `xhost +SI:localuser:"$USER"` [#20](https://github.com/mdouchement/docker-zoom-us/issues/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](https://github.com/mdouchement/docker-zoom-us/issues/1)
- @mzcu made a fix [mzcu@ee177a5](https://github.com/mzcu/docker-zoom-us/commit/ee177a5e8915a05a51080301996a8ed4b89552ee) that should work
- I recommend you to try his version: https://github.com/mzcu/docker-zoom-us