Docker: Camoufox fails to launch with GUI/non-headless mode

[aastha231074]

Describe the bug:

What I'm trying to do: Launch Camoufox with a visible browser window inside Docker

Environment:

Docker version: 20.10.12
Camoufox version: 0.4.11
Container base image: python:3.11-slim

FROM python:3.11-slim

ENV DEBIAN_FRONTEND=noninteractive

WORKDIR /app

RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        # VNC
        tigervnc-standalone-server \
        tigervnc-common \
        tigervnc-tools \
    xauth \
        xvfb \
        \
        # Window manager (required)
        openbox \
        \
        # X11 core libs
        x11-common \
        xfonts-base \
        xkb-data \
        libx11-6 \
        libxext6 \
        libxrender1 \
        libxi6 \
        libxtst6 \
        libxfixes3 \
        \
        # Browser deps
        libgtk-3-0 \
        libdbus-glib-1-2 \
        libx11-xcb1 \
        libxcomposite1 \
        libxdamage1 \
        libxrandr2 \
        libatspi2.0-0 \
        libatk1.0-0 \
        libcups2 \
        libxss1 \
        libdrm2 \
        libgbm1 \
        libpangocairo-1.0-0 \
        \
        # Misc required
        fonts-liberation \
        libasound2 \
        ca-certificates \
        wget \
        unzip \
    && rm -rf /var/lib/apt/lists/*

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

[icepaq]

@aastha231074 python docker images are based on debian images which don't have a display driver. So launching headful mode wouldn't work because there is no display to launch on.

Instead, you can try to launch it in virtual mode. Check out the docs here https://camoufox.com/python/virtual-display/

If you keep running into the issue can you share a snippet of the code you're using to launch camoufox.

[aastha231074]

But if I have to solve captcha in it then I need a headful mode, right?

[icepaq]

Not necessarily. You should be able to solve captchas in headless.

[JWriter20]

@aastha231074 This isn't a Camoufox defect — the python:3.11-slim image has no display server, so headful mode has nothing to render on. Use virtual-display mode (https://camoufox.com/python/virtual-display/), which runs headlessly and can still solve captchas. Closing as environment-related; comment if virtual mode doesn't work for you and we'll reopen.