From f0b19ccff65ad1a2adbf0c43e84d4a5adeda3d87 Mon Sep 17 00:00:00 2001 From: Joseph Hunkeler Date: Fri, 18 Mar 2016 09:39:53 -0400 Subject: Initital commit --- source/installation.rst | 60 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 source/installation.rst (limited to 'source/installation.rst') diff --git a/source/installation.rst b/source/installation.rst new file mode 100644 index 0000000..39260aa --- /dev/null +++ b/source/installation.rst @@ -0,0 +1,60 @@ +############ +Installation +############ + + +Obtain Anaconda +================ + +.. note:: AstroConda packages are 64-bit only. We may consider building 32-bit binaries for Linux if there is a demand for it. + +Grab a copy of the `Anaconda3 `_ distribution from Continuum, Inc. + +Be sure to select the installer appropriate for your operating system and architecture. Installation instructions are +available on the download page. + + +Configure Conda +=============== + +In order to install packages directly from the AstroConda repository, you will need to configure Anaconda to do so. +This will permanently add the repository to Conda's search path. Be aware that adding additional +`anaconda.org `_ repositories to this file may affect the stability of AstroConda's run-time +environment. + +Use a plain-text editor to append the following to $HOME/.condarc: + +.. code-block:: sh + + channels: + - astroconda + - defaults + + +Install AstroConda +================== + +Now that conda is configured to pull from our repository, you may now go ahead and install the ``astroconda`` +meta-package. + +.. code-block:: sh + + $ conda create -n astroconda astroconda + $ source activate astroconda + + + +Fine-tuning the installation +============================ + +If you are short on hard drive space, have a slow internet connection, or are simply not interested in installing +*everything but the kitchen sink*; please feel free to peruse the `manifest `_ and +install a custom mix of packages *tailored to your needs*. + +.. code-block:: sh + + $ conda create -n astroconda [package [package ...]] + $ source activate astroconda + + + -- cgit