On April 23, 2026, Kameleo announced an official Docker image for Linux on its blog. Before that, the kameleo/kameleo-app image on Docker Hub was built only for Windows: tags 4.2.0–4.3.0 included only a windows/amd64 variant, while linux/amd64 first appeared with tag 4.4.0. The latest tag now automatically selects the variant for the host OS, and the Linux build is based on Ubuntu 22.04.
The Linux image supports both Kameleo browser engines: Chroma, based on Chromium, and Junglefox, based on Firefox. The browser runs without a display or GPU and can be controlled through any CDP client, such as Playwright or Puppeteer. Kameleo’s founder says that, before this, customers kept Windows virtual machines in AWS solely to run Kameleo, while one enterprise customer built its own Docker wrapper around another browser.
The company identified the initial limitations itself: speech synthesis and Widevine did not work in the container, and software rendering through SwiftShader had to be enabled manually. According to the browser kernel release page, the Chroma 147 update from April 21 made SwiftShader the default fallback for WebGL, while version 4.4.1 enabled the image to use the host GPU when available. Widevine started working in Chroma 148 (May 4), and speech synthesis was fixed on May 28.
What to do: Start the container with the --shm-size=2g flag because, according to the developers, the default 64 MB of /dev/shm is not enough and causes the browser to crash. Store data in a named volume rather than a host directory. Starting with version 5.0, authentication in the container uses a PAT.
