In this guide, we look at multiple ways to run the Zetane Viewer from inside a Docker container:
For ideas of what to try once the Viewer is up and running, be sure to check out our quick start video tutorial:
<aside> 👷 Thank you for your interest in containerized Zetane! This mode of deployment is in early development; we look forward to continue improving it, approaching native desktop fidelity and experience.
</aside>
This is an example of a minimal setup to run Zetane inside a Docker image, with CPU (software) rendering, on a local machine. This setup does not require a GPU, and has been tested on bare systems, including Live USB.
<aside> 💡 Note: on Linux systems with NVIDIA drivers installed, this software rendering method might not work. In that case, try the NVIDIA-accelerated Zetane Dockerfile instead.
</aside>
Install Docker on a supported host:
Dockerfile (based on Ubuntu 18.04 LTS or higher):
FROM ubuntu:18.04
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y libgl1 wget
ENV ZTN_DEB=Zetane-1.7.0.deb
RUN wget <https://download.zetane.com/zetane/$ZTN_DEB> \\
&& apt-get install -y ./$ZTN_DEB \\
&& rm -rf ./$ZTN_DEB
# To open help URLs (optional)
RUN apt install -y xdg-utils firefox
Build and run on Linux (might need sudo, depending on your docker setup):
docker build . --rm -t zetane
xhost +si:localuser:root
docker run --rm -it --net=host -e DISPLAY zetane zetane
Build and run on Windows:
docker build . --rm -t zetane
docker run --rm -it -e DISPLAY=host.docker.internal:0 zetane zetane
This option is recommended on platforms with supported NVIDIA GPUs. It provides hardware-accelerated rendering with a similar graphical performance to being natively launched on the same system.
<aside> 🚧 Currently, only GLX (interactive) sessions have been tested. Off-screen (EGL) rendering is in development.
</aside>