.. Silas documentation master file, created by
   sphinx-quickstart on Mon Nov 19 12:49:44 2018.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. _sec-install-setup:

Installation and Setup
======================

.. toctree::
   :maxdepth: 2
   :caption: Contents:

.. _sec-install-silas:

Install Silas
-------------

.. _sec-install-linux:

Linux
^^^^^

On **Debian**, Silas works right out of the zip. On other distributions, you may need to install the **TBB library**. For instance, on **Ubuntu** you may install it using the following commands::
 
   sudo apt update 
   sudo apt install libtbb-dev

If the package libtbb-dev cannot be located, you can add *universe* in your sources.list using the following command::

   sudo sh -c 'echo "deb http://archive.ubuntu.com/ubuntu/ bionic universe" >> /etc/apt/sources.list'

If you wish to run Silas from any directory, you can :ref:`include the executable directory in "PATH" <sec-set-path-linux>`.

.. _sec-install-mac:

Mac
^^^

On a Mac, you can install the TBB library using Homebrew. You can install Homebrew using the commands below::

   xcode-select --install
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Once Homebrew is installed, you can install the TBB library using the following command::

   brew install tbb

Then Silas should work. Note that you may need to grant Silas the access the run in System Preferences -> Security & privacy -> General tab.

.. _sec-install-windows:

Windows
^^^^^^^

On Windows, you can run Silas in the Linux Subsystem. You can refer to Microsoft's website about how to install and run the Linux Subssytem on Windows.

`Tutorial on Linux Subssytem on Windows <https://docs.microsoft.com/en-us/learn/modules/get-started-with-windows-subsystem-for-linux/>`_


.. Indices and tables
.. ==================

.. * :ref:`genindex`
.. * :ref:`modindex`
.. * :ref:`search`