Skip to content

Instantly share code, notes, and snippets.

@zhuoqun-chen
Forked from cschiewek/x11_docker_mac.md
Created July 23, 2023 05:21
Show Gist options
  • Save zhuoqun-chen/64aec83ebaec00976942402f2341472d to your computer and use it in GitHub Desktop.
Save zhuoqun-chen/64aec83ebaec00976942402f2341472d 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