Go to file
Oskar Hahn 619d14340b Merge pull request #86 from andkit/no_browser
Add an option to suppress starting of web browser (closes #436)
2013-01-22 12:25:59 -08:00
docs Doc: Prepared manual for publishing. 2012-07-25 17:12:03 +02:00
extras Fixed file name and path to renamed groups_de.json file. 2012-11-27 22:31:41 +01:00
openslides Add an option to suppress starting of web browser (closes #436) 2013-01-22 21:04:07 +01:00
tests Update test for version string. 2012-12-01 13:39:29 +01:00
.coveragerc reordered the tests 2012-11-24 15:00:17 +01:00
.gitattributes Fixed folder list for .gitattributes. 2012-10-31 09:06:56 +01:00
.gitignore clean up the .gitignore 2012-12-16 18:28:24 +01:00
.travis.yml Some fixes. Update requirements.txt and setup.py. 2013-01-05 23:20:38 +01:00
AUTHORS Added extra line 2012-11-27 22:55:41 +01:00
CHANGELOG Set next release to 1.4. Added 1.3.1 CHANGELOG from stable/1.3.x branch 2013-01-09 21:40:54 +01:00
INSTALL.txt Some fixes. Update requirements.txt and setup.py. 2013-01-05 23:20:38 +01:00
LICENSE changle end of line to windows for some files 2012-07-20 10:55:07 +02:00
manage.py fixed manage.py for windows 2012-11-28 19:20:43 +01:00
MANIFEST.in Load groups_de when creating the database 2012-11-25 01:07:39 +01:00
README.txt Set next release to 1.4. Added 1.3.1 CHANGELOG from stable/1.3.x branch 2013-01-09 21:40:54 +01:00
requirements.txt Update requirements: set version of coverage to 3.6 2013-01-17 22:33:52 +01:00
setup.py Some fixes. Update requirements.txt and setup.py. 2013-01-05 23:20:38 +01:00
start.py changed the main script 2012-08-14 14:19:59 +02:00
THANKS changle end of line to windows for some files 2012-07-20 10:55:07 +02:00

==================================
English README file for OpenSlides
==================================

This is OpenSlides, version 1.4.0 (unreleased).


What is OpenSlides?
===================
OpenSlides is a free web-based presentation and assembly system for
displaying and controlling of agenda, motions and elections of an assembly.

See http://openslides.org for more information.


Getting started
===============
Install and start OpenSlides as described in the INSTALL.txt.

If you need help please contact the OpenSlides team on public mailing
list or read the OpenSlides manual. See http://openslides.org.


The start script of OpenSlides
==============================
Simply running
  openslides.exe (on Windows)
or
  openslides (on Linux/MacOS)

will start OpenSlides using djangos development server. It will also
try to open OpenSlides in your default webbrowser.

The server will listen on the IP address of your current hostname on
port 80 (if port 80 is not available port 8000 will be used).
This means that the server will be available to everyone on your
local network (at least for commonly used network configurations).

See `Command line options` below if you need to change this.

The login for the default admin user after (created on first start),
is as follows:

  Username: admin
  Password: admin


Command line options
--------------------
The following command line options are available:

-h, --help
    Shows all options

-a, --address=ADDRESS
    Changes the address on which the server will listen for connections

-p PORT, --port=PORT
    Changes the port on which the server will listen for connections

--syncdb
    Creates/updates database before starting the server

--reset-admin
    Resets the password to 'admin' for user 'admin'

-s SETTINGS, --settings=SETTINGS
    Sets the path to the settings file.

--no-reload
    Does not reload the development server

--version
    Show version and exit.

Example 1: Openslides should only be accessible on this computer:
  openslides -a 127.0.0.1

Example 2: Like above, but also specify the port as 8080
  openslides -a 127.0.0.01 -p 8080


Supported operating systems and browsers
========================================
Operating Systems (OpenSlides runs anywhere where Pyhton is running):
  Windows XP or newer (32 and 64bit)
  MacOS X
  GNU/Linux

Browsers:
  Firefox 3.6+
  IE 7+
  Chrome
  Safari