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

You can install Anaconda using either the graphical installer ("wizard") or the
command line ("manual") instructions below. If you are unsure, choose the graphical install.

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

#. Download the graphical `macOS installer <https://www.anaconda.com/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 downloaded file and click continue to start the installation..

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

#. Click the Install button to install Anaconda in your home user directory (recommended):

   .. figure:: /img/customizebutton.png

      ..

   |



#. OR, click the Change Install Location button to install in another location (not recommended).

   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

         ..

      |



#. Click the continue button.

#. Optional: To :doc:`install VS Code <../user-guide/tasks/integration/vscode>`,
   click the Install Microsoft VS Code button. After the install completes click
   the Continue button.

   .. figure:: /img/vscode-macos-install.png
      :width: 50%

      ..

   |

   Or to install Anaconda without VS Code, click the Continue button.

   NOTE: Installing VS Code with the Anaconda installer requires an internet connection.
   Offline users may be able to find an offline VS Code installer from Microsoft.

#. A successful installation displays the following screen:

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

      ..

   |

#. After your install is complete, verify it by opening Anaconda Navigator, a
   program that is included with Anaconda: from Launchpad, select
   Anaconda Navigator. If Navigator opens, you have successfully
   installed Anaconda. If not, check that you completed each step above, then
   see our :doc:`Help page <../help-support>`

   TIP: Anaconda Navigator contains Jupyter Notebook and the Spyder IDE. For more
   information about using Navigator, see :doc:`Navigator <../navigator/index>`.


Using the command-line install
==============================

Use this method if you prefer to use a terminal window.

#. In your browser, download the command-line version of the
   `macOS installer <https://www.anaconda.com/downloads#macos>`_ for your system.

#. 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 3.6 or 2.7:

   * For Python 3.6 enter the following::

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

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

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

   NOTE: Include the ``bash`` command regardless of whether or not you are using the Bash shell.

   NOTE: Replace ``~/Downloads`` with your actual path and ``Anaconda3-5.2.0-MacOSX-x86_64.sh`` with actual name of the file you downloaded.

#. The installer prompts "In order to continue the installation process, please review the license agreement."
   Click Enter to view license terms.

#. Scroll to the bottom of the license terms and enter yes to agree to them.

#. The installer prompts you to Press Enter to confirm the location, Press CTRL-C to cancel the installation
   or specify an alternate installation directory. If you accept the default install location, the installer
   displays "PREFIX=/home/<user>/anaconda<2 or 3>" and continues the installation. It may take a few minutes to complete.

   NOTE: We recommend you accept the default install location.

#. The installer prompts "Do you wish the installer to prepend the Anaconda install location to PATH
   in your /home/<user>/.bash_profile ?" We recommend "yes".

   NOTE: If you enter "no", specify the path to Anaconda.

   * Add ``export PATH="/<path to anaconda>/bin:$PATH"`` in .bashrc or .bash_profile.

   * Or set the PATH variable: ``export PATH="/<path to anaconda>/bin:$PATH"``

   Replace "<path to anaconda>" with the actual path to your Anaconda installation.

#. The installer finishes and displays "Thank you for installing Anaconda!"

#. The installer describes Microsoft VS Code and asks if you would like to
   install VS Code. Enter ``yes`` or ``no``. If you selected ``yes``, follow the
   instructions on screen to complete the VS Code installation.

   NOTE: Installing VS Code with the Anaconda installer requires an internet connection.
   Offline users may be able to find an offline VS Code installer from Microsoft.

#. Close and open your terminal window for the installation to take effect.

#. To verify the installation, see :doc:`Verifying your installation <verify-install>`.

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