[GH-ISSUE #1697] Documentation: Docker VNC + Chromium + pihole #4027

Open
opened 2026-03-15 01:20:23 +03:00 by kerem · 0 comments
Owner

Originally created by @gheja on GitHub (Sep 30, 2025).
Original GitHub issue: https://github.com/ArchiveBox/ArchiveBox/issues/1697

Originally assigned to: @pirate on GitHub.

What is the URL of the page you'd like to see improved?

https://github.com/ArchiveBox/ArchiveBox/wiki/Chromium-Install#docker-vnc-setup

What is the title of the relevant section?

Docker VNC Setup

What is the suggested edit?

When using pihole, we need to uncomment in the archivebox service the following:

networks:
  - dns

This drops the connection to default network which renders novnc unusable for Chromium as DISPLAY=novnc:0.0 specifies a display that is no longer reachable.

$ docker compose run archivebox /usr/bin/chromium-browser --user-data-dir=[...]
[...]
[7:7:0930/213334.829180:ERROR:ozone_platform_x11.cc(244)] Missing X server or $DISPLAY
[7:7:0930/213334.829737:ERROR:env.cc(257)] The platform failed to initialize.  Exiting.

We need to extend the network list with default:

networks:
  - dns
  - default

After this change the browser starts as expected.

Originally created by @gheja on GitHub (Sep 30, 2025). Original GitHub issue: https://github.com/ArchiveBox/ArchiveBox/issues/1697 Originally assigned to: @pirate on GitHub. ### What is the URL of the page you'd like to see improved? https://github.com/ArchiveBox/ArchiveBox/wiki/Chromium-Install#docker-vnc-setup ### What is the title of the relevant section? Docker VNC Setup ### What is the suggested edit? When using `pihole`, we need to uncomment in the `archivebox` service the following: ``` networks: - dns ``` This drops the connection to `default` network which renders `novnc` unusable for Chromium as `DISPLAY=novnc:0.0` specifies a display that is no longer reachable. ``` $ docker compose run archivebox /usr/bin/chromium-browser --user-data-dir=[...] [...] [7:7:0930/213334.829180:ERROR:ozone_platform_x11.cc(244)] Missing X server or $DISPLAY [7:7:0930/213334.829737:ERROR:env.cc(257)] The platform failed to initialize. Exiting. ``` We need to extend the network list with `default`: ``` networks: - dns - default ``` After this change the browser starts as expected.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/ArchiveBox#4027
No description provided.