Product, Use Cases

Installing Mesos on your Mac with Homebrew

For more than five years, DC/OS has enabled some of the largest, most sophisticated enterprises in the world to achieve unparalleled levels of efficiency, reliability, and scalability from their IT infrastructure. But now it is time to pass the torch to a new generation of technology: the D2iQ Kubernetes Platform (DKP). Why? Kubernetes has now achieved a level of capability that only DC/OS could formerly provide and is now evolving and improving far faster (as is true of its supporting ecosystem). That’s why we have chosen to sunset DC/OS, with an end-of-life date of October 31, 2021. With DKP, our customers get the same benefits provided by DC/OS and more, as well as access to the most impressive pace of innovation the technology world has ever seen. This was not an easy decision to make, but we are dedicated to enabling our customers to accelerate their digital transformations, so they can increase the velocity and responsiveness of their organizations to an ever-more challenging future. And the best way to do that right now is with DKP.

Jul 07, 2014

Sunil Shah


It's often difficult to get a local environment set up on your Mac, especially if you are working with a distributed system like Mesos. You want a simple way to get all of the essential files onto your computer, placed in the right directories, and ready to begin work. Enter Homebrew, which makes setup easy.


Using Homebrew to Install Mesos


Homebrew is an open source package management system for the Mac that simplifies installation of packages from source. It handles dependencies and updates automatically through a simple command line tool, brew.


If you don't yet have Homebrew, you can install it with one command:


ruby -e "$(curl -fsSL"


Once you have Homebrew installed, you can install Mesos on your laptop with these two commands:


brew updatebrew install mesos


You will need to wait while the most current, stable version of Mesos is downloaded, compiled, and installed on your machine. This could take upwards of 20 minutes (largely because brew compiles Mesos locally), but Homebrew will let you know when it's finished by displaying a beer emoji in your terminal and a message like the following:


/usr/local/Cellar/mesos/0.19.0: 83 files, 24M, built in 17.4 minutes


Start Your Mesos Cluster


Now that you have Mesos installed on your laptop, it's easy to start your Mesos cluster. To see Mesos in action, spin up an in-memory master with the following command:


/usr/local/sbin/mesos-master --registry=in_memory --ip=


A Mesos cluster needs at least one Mesos Master to coordinate and dispatch tasks onto Mesos Slaves. When experimenting on your laptop, a single master is all you need. Full production clusters, such as those you might run in a public cloud or in a private datacenter, will usually run Mesos in High Availability Mode. A highly-available Mesos cluster (designed for fault-tolerance with no single point of failure) will often have three or more masters running.


Once your Mesos Master has started, you can visit its management console: http://localhost:5050


Since a Mesos Master needs slaves onto which it will dispatch jobs, you might also want to run some of those. Mesos Slaves can be started by running the following command for each slave you wish to launch:


sudo /usr/local/sbin/mesos-slave --master=


Exploring More


Want to learn more about what you can do with Mesos? Visit our Learn page and take a look at the Documentation Center on the official Apache Mesos site.

Ready to get started?