1. How To Install Xquartz On Mac With High Sierra
  2. How To Use Xquartz On Mac
Install Xquartz On Mac

XQuartz is a shell that runs on OS X enabling you to develop on a Macintosh computer in a similar way to how you would develop on a Linux computer. This is accomplished by providing a user interface (a 'shell') build on the same X Window System that Linux is built on. Note that XQuartz was developed by Apple and, as such, is a supported development platform.

Once you have installed XQuartz on your computer, you can use emacs in a separate window much like you can on a native Linux computer. You can also run OpenGL applications such as the ones we develop in CS 165.

Native X11 support on Apple Silicon. I am used to running apps via macports with Xquartz (X11) on Macs. I have been using macports for over 10 years. Now, since the shift to arm (Apple Silicon) I cannot install apps via macports due to lack of compatible apps and compatible libraries. These apps mactex and various other linux based scientific. The XQuartz appplication must be installed before installing Wine. Note: Please note, that applications XQuartz and Wine for Apple Mac are not developed nor supported by Embird team. Also, because Embird is natively Windows application, it is not quaranteed that all portions of program run smoothly in Wine on Apple Mac.


In order to get up-and-running with XQuartz, you will need to install the XQuartz application. The following instructions explain how to install the necessary tools to remotely access GUI applications running on Linux Lab computers from a system running Apple Macintosh OS X. Of course, this document does not cover how to install the tools on Microsoft Windows computers.

XQuartz Log Out Warning for Setting X11 as Default. The software installer will start installing XQuartz onto your mac. When completed the installer will show a summary stating, that the installation was successful (see Figure 10). Click on the ‘Close’ button. After installing XQuartz restart your machine. Install Docker for Mac. Install docker using brew cask install docker or directly from the website here. Start XQuartz from command line using open -a XQuartz. In the XQuartz preferences, go to the “Security” tab and make sure you’ve got “Allow connections from network clients.

1. Download

Download XQuartz dmg package on the web site http://www.xquartz.org/

Figure 1 - XQuartz web site

2. Start installation

Install Xquartz On Mac

Double click the downloaded file to start the installation process. You should see the screen below (See figure 2). Just click 'Continue.'

Figure 2 - Beginning installation

3. Readme

The next scheme describes any notifications about this release. Click 'Continue.'

Figure 3 - Important information


For the license agreement, click 'Continue' (See figure 4) and on the pop up you must choose 'Agree' (See figure 5) otherwise the installation will be canceled

Figure 4 - License agreement

Figure 5 - Pop up asking for your agreement


5. Installation Type

The next screen will show you how much space you need to complete the installation. It takes 185.9 MB of space on your computer. Click 'Install' to continue. (See figure 6)

How To Install Xquartz On Mac With High Sierra

Figure 6 - Space requirements

6. Installation

You will need to provide your Mac username and password in order to continue the installation process. (See figure 7)

Figure 7 - Mac username and password required

This step of the process can take a few minutes. Even though seems stuck, just wait until the progress bar is full. (See figure 6)


Figure 8 - Wait until the progress bar is complete

You should see the message after the progress bar is complete. It is just an informative message telling you to log out and log back in to use the application. (See figure 9)

Figure 9 - Informative Message

Finally, you will see the message saying 'The installation was successful.' The installation is now complete. (See figure 10)

Figure 10 - Installation Complete

Running XQuarts

In order to test the new application, first log out and log back in. Then open the terminal window and type the following command where 2xx may be 201 through 210 and 'yourusername' is replaced by the username you use to log in to the Linux Lab computers

How To Use Xquartz On Mac

Figure 11 - Terminal command

The first time you access Linux Lab through this process you should see a message like the one below (See figure 12). This is normal. It is just saying the file .Xauthority used to graphical remote access does not exist, but Linux will create one for you. The next time this message won't appear anymore.

Figure 12 - File does not exist

When you see your username followed by '@' and the hostname of the machine (ausXXXX) as pointed by the arrow below, you know you are already inside the Linux Lab terminal. Type 'gedit' to open the GUI text editor to test it. You should see the graphical text editor as shown below. (See figure 13)

Figure 13 - gedit GUI

Now you can use the Linux Lab GUI applications remotely on your Macintosh.