OpenSlides/INSTALL

Installation Instructions for OpenSlides 1.2
============================================

Content
-------
I.  Installation on Windows (32/64bit)
II. Installation on GNU/Linux and MacOSX



I. Installation on Windows (32/64bit)
-------------------------------------

  1. Install Python 2.7

     a) Download and run 32bit MSI installer from http://www.python.org/download/
        e.g. version 2.7.2:
        http://www.python.org/ftp/python/2.7.2/python-2.7.2.msi

     b) Add python dirs to PATH (via Control Panel > System > Advanced):

         ";C:\Python27;C:\Python27\Scripts"

  2. Install Setuptools 0.6c11

     Download and run 32bit binary installer from http://pypi.python.org/pypi/setuptools:
     http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe

  3. Install required packages
     Open command line (cmd) and run:

       easy_install django django-mptt reportlab pil

     If you, nevertheless, use a 64bit version of Python, you have to install reportlab
     and pil not by using easy_install but manually.

  4. Get OpenSlides:

     a) Download latest OpenSlides release from http://openslides.org.

        OR

     b) Clone development version from mercurial repository:

        hg clone http://hg.openslides.org

  5. Start OpenSlides server and open URL in your default browser:

       python start.py

     If you run this script the first time new database and admin account
     are created. Please change the password after first login!

       Username: admin
       Password: admin

     Use 'python start.py --help' to show all start options.



II. Installation on GNU/Linux and MacOSX
----------------------------------------

Make sure that you have installed python and virtualenv on your
system.

  1. OpenSlides requires following programs, which should be
     installed first: python 2 (>=2.5), virtualenv, reportlab, pil

     E.g. for ubuntu run:
     $ sudo apt-get install python python-virtualenv python-reportlab python-imagin

  2. Get OpenSlides:

     a) Download latest OpenSlides release from http://openslides.org.

        OR

     b) Clone development version from mercurial repository:

        $ hg clone -r 1.2-dev http://hg.openslides.org

      You have to install mercurial. For Ubuntu run:

        $ sudo apt-get install mercurial

  3. Setup virtualenv:

        Go to the (extracted/cloned) root directory of OpenSlides
        and create virtualenv environment:

        $ virtualenv --system-site-packages .venv

        Activate the virtualenv environment:

        $ . .venv/bin/activate


  4. Install required packages:

        $ pip install django django-mptt

        If you use python 2.5 you also have to install 'simplejson'

        $ pip install simplejson

  5. Start OpenSlides server and open URL in your default browser:

       $ python start.py

     If you run this script the first time new database and admin account
     are created. Please change the password after first login!

       Username: admin
       Password: admin

     Use 'python start.py --help' to show all start options.


--
If you need help ask on OpenSlides users mailing list.
See http://openslides.org for more information.