install-mongodb-on-os-x.txt

========================
Install MongoDB on macOS
========================

.. default-domain:: mongodb

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

Overview
--------

Use this tutorial to install MongoDB on macOS systems.

.. admonition:: Platform Support

   .. include:: /includes/fact-macos-support.rst

MongoDB is available through the popular macOS package manager `Homebrew
<http://brew.sh/>`_ or through the `MongoDB Download site
<http://www.mongodb.org/downloads>`_.

Install MongoDB
---------------

You can install MongoDB with `Homebrew <http://brew.sh/>`_ or manually.
This section describes both.

.. _install-with-homebrew:

Install MongoDB with Homebrew
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

`Homebrew <http://brew.sh/>`_ installs binary packages based on published
"formulae." This section describes how to update ``brew`` to the latest
packages and install MongoDB. Homebrew requires some initial setup and
configuration, which is beyond the scope of this document.

.. include:: /includes/steps/install-mongodb-on-osx-with-homebrew.rst

Install MongoDB Manually
~~~~~~~~~~~~~~~~~~~~~~~~

Only install MongoDB using this procedure if you cannot use
:ref:`homebrew <install-with-homebrew>`.

.. include:: /includes/steps/install-mongodb-on-osx-manually.rst

Run MongoDB
-----------

.. include:: /includes/steps/run-mongodb-on-linux.rst