======================
Installing on macOS
======================

You can install Anaconda using either the graphical installer or the command line.

macOS graphical install
=======================

#. Download the graphical `macOS installer <https://www.continuum.io/downloads#macos>`_ for your version of Python.

#. OPTIONAL: :doc:`Verify data integrity with MD5 or SHA-256 <hashes/index>`.
   For more information on hashes, see `What about cryptographic hash verification? <http://conda.pydata.org/docs/download.html#what-about-cryptographic-hash-verification>`_.

#. Double-click the ``.pkg`` file. 

#. Answer the prompts on the Introduction, Read Me and License screens.

#. On the Destination Select screen, select Install for me only.

   NOTE: If you get the error message "You cannot install Anaconda in this location," reselect Install for me only.

   .. figure:: /img/osxbug2.png

      ..
   
   |

#. On the Installation Type screen, you may choose to install in another location. The standard install puts Anaconda in your home user directory:

   .. figure:: /img/customizebutton.png

      ..
   
   |

#. Advanced users may click the Customize button to avoid 
   adding Anaconda to the bash PATH:


   .. figure:: /img/pathoption.png

      ..

   |

#. Click the Install button.

   A successful installation displays the following screen:

   .. figure:: /img/anaconda-install-osx.png

      ..
   
   |

#. OPTIONAL: Verify the installation. :doc:`verify-install`.


Using the command-line installer
==================================

#. Download the command-line `macOS installer <https://www.continuum.io/downloads#macos>`_.

#. To download the command line installer for your version of Python, click the appropriate Command Line Installer button. 

#. OPTIONAL: :doc:`Verify data integrity with MD5 or SHA-256 <hashes/index>`.
   For more information on hashes, see `What about cryptographic hash verification? <http://conda.pydata.org/docs/download.html#what-about-cryptographic-hash-verification>`_

#. Install for Python 2.7 or 3.6:

   * For Python 2.7, open the Terminal.app or iTerm2 terminal application, and then enter the following::

       bash ~/Downloads/Anaconda2-4.4.0-MacOSX-x86_64.sh

   * For Python 3.6 enter the following::

       bash ~/Downloads/Anaconda3-4.4.0-MacOSX-x86_64.sh

   NOTE: Include the ``bash`` command regardless of whether you are 
   actually using the Bash shell.
   
   NOTE: Replace ``~/Downloads`` with your actual path and ``Anaconda3-4.4.0-MacOSX-x86_64.sh`` with your actual filename.

   A successful installation displays the messages "Installation finished" and "Thank you for installing Anaconda."

To begin using Anaconda, see :doc:`../user-guide/getting-started`.
