****************************
Installing CIVET
****************************

To date we’ve only installed the system on Macintosh computers (OS-X), though
the only difference between a Macintosh installation and other
installations should be the installation of the Django system.

On Macintoshes running OS-X 9 and 10, the required Python 2.7 comes
pre-installed. The ``pip`` installation program may also be
pre-installed—I’m having trouble determining this from the Web, and
forget whether I had to install it when I last upgraded—but if not,
install that.

#. In the Terminal, run ``sudo pip install Django``: you will need
   administrative access to do this.

#. Download the CIVET system from
   https://github.com/civet-software/CIVET-Django, unzip the folder and
   put it wherever you would like

#. In the Terminal, change the directory so that you are in the folder
   *Django\_CIVET/djcivet\_site*

#. In the Terminal, enter ``python manage.py runserver``

#. In a browser, enter the URL http://127.0.0.1:8000

At this point you should see the CIVET home screen [#f1]_

.. figure:: civethome.png
   :width: 100%
   :alt: CIVET home screen

Modifying the default installation
==================================

Because CIVET is still in beta, the version on GitHub is the one being used for 
development. To deploy the system for active coding, you will probably want
to make the following changes:

#. In the file *djcivet_site/djcivet_site/settings.py*, set ``DEBUG = False``.
    This will 
    
    It is appropriate to note the `Django documentation advice <https://docs.djangoproject.com/en/1.8/ref/settings/>`_ 
    on this::
    
        Never deploy a site into production with DEBUG turned on.
        
        Did you catch that? NEVER deploy a site into production with DEBUG turned on.
    
    As the Django documentation discusses in detail, with ``DEBUG = True`` any
    errors will generate an error page containing extensive internal detail 
    about your site. With ``DEBUG = False``, the user just sees a ``Page not found``
    error.

.. rubric:: Footnotes

.. [#f1]
   If you see a log-in page requesting a user name and password, the log-in requirement 
   has been activated: see the “Authentication” chapter for details on how to use 
   (or deactivate) this.