==============================
Alternate installation options
==============================

NOTE: If you already have Anaconda installed on your computer, you must use the recommended method, :doc:`install Anaconda Fusion with Navigator <install>` to prevent two copies of Anaconda from being installed on your system which could lead to system conflicts. 

If you do not have Anaconda installed on your computer, and do not want to follow the recommended method of using Anaconda Navigator, Fusion can be installed in these other ways:

- :ref:`Command line install Fusion with conda <fusion_install_conda>` for Windows or macOS.

- :ref:`Standalone installer for Windows <fusion_install_win>` 

- :ref:`Standalone installer for macOS <fusion_install_mac>`.


.. _fusion_install_conda:

Install Fusion using a conda package on Windows or macOS
========================================================

If you already have an Anaconda installation and are familiar with conda, you can install Anaconda Fusion as a conda package.

NOTE: Fusion requires Python 3.5. You may create a Python 3.5 conda environment and install Fusion there even if your conda root environment uses another Python version such as Python 2.7.

Before you start, update Microsoft Excel to be sure you have the latest version. Anaconda Fusion works only with version 15.18 or higher.

Excel must be opened and closed at least once before installing Fusion.

First, create the new conda environment in which to install Anaconda Fusion.

WINDOWS:

.. code-block:: bash

    conda create -n fusion-env python=3.5
    activate fusion-env

NOTE: You may replace "fusion-env" with any name you choose for your Fusion environment.

macOS:

.. code-block:: bash

    conda create -n fusion-env python=3.5
    source activate fusion-env

NOTE: You may replace "fusion-env" with any name you choose for your Fusion environment.

Now install Anaconda Fusion with the following command:

.. code-block:: bash

    conda install -c anaconda-fusion anaconda-fusion

Next, for Windows, follow the steps from step 4 below in :ref:`fusion_install_win`.

For macOS, follow the steps from step 4 below in :ref:`fusion_install_mac`.


Conda package update
====================

To update Anaconda Fusion to each new release, be sure to close Excel, and then in a terminal window run the following command: `conda update -c anaconda-fusion anaconda-fusion`.


Conda package uninstall
=======================

To uninstall Anaconda Fusion, in a terminal window, activate your conda environment and run conda remove:

.. code-block:: bash

    source activate your-environment-name
    conda remove anaconda-fusion

NOTE: Replace "your-environment-name" with the actual name of your environment.


.. _fusion_install_win:

Windows install
===============

Before you start, update Microsoft Excel to be sure you have the latest version. Anaconda Fusion works only with version 15.18 or higher.

Excel must be opened and closed at least once before installing Fusion.

1. Download the `Anaconda Fusion Windows installer  <https://anaconda.org/anaconda-fusion/anaconda-fusion/1.0.2/download/AnacondaFusion-1.0.2-Windows-x86_64.exe>`_.

   |

2. Find the downloaded file in your Downloads folder named ``AnacondaFusion-1.0.2-Windows-x86_64.exe`` and double-click it to install Fusion.

   |

3. Follow the prompts in the Installation Wizard.

**NOTE:** The installation will ask to be granted administrative rights so it can register all the assets required by Excel Office365 Add-Ins. If the administrative rights are not granted the registration of these assets will fail and Anaconda Fusion will be installed in the system but not visible from Excel. To solve this problem please refer to the :ref:`fusion_install_win_manually` and the :ref:`fusion_register_catalog_win` sections in :doc:`troubleshooting`.


4. Now you can click the "Anaconda Fusion" icon in your Apps Dashboard.

   .. figure:: /img/fusion_start_fusion.png
       :width: 50%

   |

5. That's it. Now open Excel and refer to the :ref:`start_fusion_windows` paragraph to learn how to activate Anaconda Fusion on Excel.


.. _start_fusion_windows:

Start Anaconda Fusion on Windows
================================

**Run Anaconda Fusion:**

* If you have followed the :ref:`Windows installation instructions <fusion_install_win>`, click on the Anaconda Fusion icon from the start menu. You will see a terminal window showing the server log.

.. figure:: /img/fusion_windows_icon.png
    :width: 70%


* If you have followed the :ref:`Conda package installation instructions <fusion_install_conda>`, open a terminal window. Activate your conda environment by typing the command ``activate your-environment-name`` and pressing return. Replace 'your-environment-name' with the actual name of your conda environment. Once the environment is active you can run Fusion by typing the command ``fusion`` and pressing return.

.. code-block:: bash

    activate fusion-env
    fusion

This will open Microsoft Excel.


To use Anaconda Fusion, see our guide :doc:`getting-started`.


.. _fusion_install_mac:

macOS install
=============

Before you start, update Microsoft Excel to be sure you have the latest version. Anaconda Fusion works only with version 15.18 or higher.

Excel must be opened and closed at least once before installing Fusion.

1. Download the `Anaconda Fusion macOS installer <https://anaconda.org/anaconda-fusion/anaconda-fusion/1.0.2/download/AnacondaFusion-1.0.2-MacOSX-x86_64.sh>`_.

2. Open a terminal window, navigate to the downloads file folder (usually ``cd Downloads``), and type the command ``bash AnacondaFusion-1.0.2-MacOSX-x86_64.sh`` to install Fusion.

3. Close and reopen your terminal for changes to take effect. Then in your terminal window, type the command ``fusion`` to run Anaconda Fusion.

4. That's it. Now open Excel and refer to the :ref:`start_fusion_mac` paragraph to learn how to activate Anaconda Fusion on Excel.

TIP: To find the Fusion Examples folder, type the command ``fusion-examples``. A new Finder window will open with all ``.xlsx`` examples files.

NOTE: Excel on macOS asks the user to grant permissions during the first Anaconda Fusion activation. When you see the "Verify Certificate" dialog box, choose "Show Certificate", select "Trust", select "Always Trust", and click "Continue":

.. figure:: /img/fusion_verify1.png
    :width: 50%

.. figure:: /img/fusion_verify2.png
    :width: 50%

.. figure:: /img/fusion_verify3.png
    :width: 50%


.. _start_fusion_mac:

Start Anaconda Fusion on macOS
==============================

**Run Anaconda Fusion:**

* If you have followed the :ref:`macOS installation instructions <fusion_install_mac>`, open a terminal window, type the command ``fusion`` and press return.

.. code-block:: bash

    fusion

* If you have followed the :ref:`Conda package installation instructions <fusion_install_conda>`, open a terminal window and activate your conda environment by typing the command ``source activate your-environment-name`` and pressing return. Replace 'your-environment-name' with the actual name of your conda environment. Once the environment is active you can run Fusion by typing the command ``fusion`` and pressing return.

.. code-block:: bash

    source activate fusion-env
    fusion

To use Anaconda Fusion, see our guide :doc:`getting-started`.

Update Windows and macOS
========================

To update Anaconda Fusion to each new release, be sure to close Excel and uninstall the current version (see below) and install the new version.


Windows uninstall
=================

To uninstall Anaconda Fusion, click the "Uninstall Anaconda Fusion" item on the Windows Start menu.


macOS uninstall
===============

To uninstall Anaconda Fusion, remove the folder where it was installed::

    rm -r ~/AnacondaFusion


Install additional dependencies in Anaconda Fusion
==================================================

If you have installed Anaconda Fusion with an installer, you can install additional conda packages with this command:

.. code-block:: bash

    conda install your-dependency-name

If you have installed Anaconda Fusion as a conda package, you can install additional conda packages with these commands:

.. code-block:: bash

    source activate your-environment-name
    conda install your-dependency-name

NOTE: Replace "your-environment-name" with the actual name of your environment and replace "your-dependency-name" with the actual name of the package you want to install.


License File Installation
=========================

The first time you start Anaconda Fusion, it will ask you to upload the license file:

.. figure:: /img/fusion_install_license.png
    :width: 70%

|

Browse your directories until you find your Anaconda Fusion license file, such as ``license_bundle_20160524191753.txt``. Click Upload. Anaconda Fusion will then start.
