Skip to content

Instantly share code, notes, and snippets.

@lhammond
Forked from cschiewek/x11_docker_mac.md
Created July 14, 2023 20:50
Show Gist options
  • Save lhammond/0713f69d430b9527fd0645747f24e9fb to your computer and use it in GitHub Desktop.
Save lhammond/0713f69d430b9527fd0645747f24e9fb 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