Setting up Kiln to work with MacOS is relatively straightforward. We have a few advanced features for Mercurial that are nice to have as well, which add more features to your command line. Of course, under the hood Kiln just serves Git or Mercurial repositories, so you can really use any tool you’d prefer!

The basics

All you need to get going is an up to date version of Git or Mercurial running. At its core, Kiln has repositories that use either Mercurial or Git on the back-end to sync data. All of the extra features sit on top of these Distributed Version Control Systems.


For Mac OS X users on Mavericks (10.9) and above, Git is usually ready to go! Just type “git” in the Terminal. It will either run, or prompt you for the rest of the necessary installation.

If you’re using a different version, or want more control over your install, you can check out Getting Stated – Installing Git at the official Git documentation.


The official Mercurial site has a downloads page with all the installers ready to go.

If you’re using Homebrew, you can also install Mercurial with a ready to go Homebrew formula. Currently, it’s “brew install mercurial”. Check the downloads page above on the Mercurial project for changes or additional package manager support.

Advanced features: The Kiln extensions

If you decide to use Mercurial, we do have some additional extensions which can make working with Kiln a bit more streamlined. These are extra features, and are not required to work with Kiln. You can safely ignore them.

If you’re interested in learning more about these extensions, we have a page about installing Kiln’s Mercurial extensions manually.

Branching out: alternate version control client software

The instructions above should get you up and running on the command line, and even get you some extra features if you’re running Mercurial. The official command-line tools are not the only clients in the world, so we’ve included links to some more popular ones on the Kiln Client and Tools downloads page. Log in to your Kiln account and navigate to your Avatar icon > Kiln Client and Tools > Custom Install to see some of our favorites.

Each of these clients requires their own setup procedures, and we’ve linked to their relevant project pages to get you started.

If you have any additional questions, please get in touch.