OpenSlides

Go to file

FinnStutzenstein 2bcab5d098 Repository restructure - moved all server related things into the folder `server`, so this configuration is parallel to the client. - All main "services" are now folders in the root directory - Added Dockerfiles to each service (currently server and client) - Added a docker compose configuration to start everything together. Currently there are heavy dependencies into https://github.com/OpenSlides/openslides-docker-compose - Resturctured the .gitignore. If someone needs something excluded, please add it to the right section. - Added initial build setup with Docker and docker-compose. - removed setup.py. We won't deliver OpenSlides via pip anymore.		2020-08-21 08:11:13 +02:00
.github/ISSUE_TEMPLATE	Update issue templates	2019-08-06 11:22:13 +02:00
client	Repository restructure	2020-08-21 08:11:13 +02:00
docker	Repository restructure	2020-08-21 08:11:13 +02:00
haproxy/src	Repository restructure	2020-08-21 08:11:13 +02:00
logo	Updated improved OpenSlides logo.	2019-09-13 13:25:41 +02:00
server	Repository restructure	2020-08-21 08:11:13 +02:00
tests/file	Repository restructure	2020-08-21 08:11:13 +02:00
.gitignore	Repository restructure	2020-08-21 08:11:13 +02:00
.travis.yml	Repository restructure	2020-08-21 08:11:13 +02:00
AUTHORS	changed email	2019-08-08 08:07:29 +02:00
CHANGELOG.rst	Updated Changelog for 3.2	2020-07-15 12:45:16 +02:00
DEVELOPMENT.rst	Repository restructure	2020-08-21 08:11:13 +02:00
LICENSE	Prepared 3.0 release	2019-09-12 23:29:55 +02:00
README.rst	Repository restructure	2020-08-21 08:11:13 +02:00

README.rst

============
 OpenSlides
============

What is OpenSlides?
===================

OpenSlides is a free, web based presentation and assembly system for
managing and projecting agenda, motions and elections of an assembly. See
https://openslides.com for more information.

Installation
============

The main deployment method is using docker and docker-compose. You just need
both installed and no further dependencies. If you want a simpler setup or are
interesed in developing, please refer to `development instructions <https://github.com/OpenSlides/OpenSlides/blob/master/DEVELOPMENT.rst>`_.

Note: This is temporary and will be replace with nice scripts...

First, you have to clone this repository::

    $ git clone https://github.com/OpenSlides/OpenSlides.git
    $ cd OpenSlides/docker/

You need to build the docker images for the client and server with this script::

    $ ./build.sh

We strongly recomment to set an initial admin password and create a second
non-admin user. Both are not strictly required (and a missing admin password will print warnings on the
startup), but if you want to have a secure setup, do::

    $ cp secrets/admin.env.example secrets/admin.env
    $ cp secrets/user.env.example secrets/user.env
    $ vi secrets/admin.env
    $ vi secrets/user.env

If the server and client are built, you can use ``docker-compose`` as usual
(except for the ``build`` method)::

    $ docker-compose up
    $ # or:
    $ docker-compose up -d
    $ docker-compose logs
    $ # ...
    $ docker-compose down

OpenSlides is listening on port 8000. It can be changed in the
``docker/docker-compose.yml``.

Bugs, features and development
================================

Feel free to create issues here in GitHub! Please use the right templates for
bugs and features and using them correctly. Pull requests are also welcome; for
a general overview of the development setup refer the `development instructions <https://github.com/OpenSlides/OpenSlides/blob/master/DEVELOPMENT.rst>`_.

Used software
=============

OpenSlides uses the following projects or parts of them:

* Several Python packages (see ``server/requirements/production.txt`` and ``server/requirements/big_mode.txt``).

* Several JavaScript packages (see ``client/package.json``)

License and authors
===================

OpenSlides is Free/Libre Open Source Software (FLOSS), and distributed
under the MIT License, see ``LICENSE`` file. The authors of OpenSlides are
mentioned in the ``AUTHORS`` file.