Skip to content

Instantly share code, notes, and snippets.

@mmattamala
Forked from cschiewek/x11_docker_mac.md
Created November 26, 2023 23:00
Show Gist options
  • Save mmattamala/04e172c29d176f6b5e2128b377e52bf4 to your computer and use it in GitHub Desktop.
Save mmattamala/04e172c29d176f6b5e2128b377e52bf4 to your computer and use it in GitHub Desktop.
X11 in docker on macOS

To forward X11 from inside a docker container to a host running macOS

  1. Install XQuartz: https://www.xquartz.org/
  2. Launch XQuartz. Under the XQuartz menu, select Preferences
  3. Go to the security tab and ensure "Allow connections from network clients" is checked.
  4. Run xhost + ${hostname} to allow connections to the macOS host *
  5. Setup a HOSTNAME env var export HOSTNAME=`hostname`*
  6. Add the following to your docker-compose:
  environment:
  - DISPLAY=${HOSTNAME}:0
  volumes:
  - /tmp/.X11-unix:/tmp/.X11-unix

* It should be noted that steps 4 and 5 can be automated to run everytime XQuartz starts, but that's outside of the scope of this gist

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment