Go to file
root ffa650d2dd Updated custom 2021-05-17 20:08:32 +02:00
config Added etherpad 2021-05-05 20:05:57 +02:00
custom Updated custom 2021-05-17 20:08:32 +02:00
docs Updated images 2021-05-06 12:31:06 +02:00
isard-apps@a3035c5f57 added new isard-apps 2021-05-12 21:23:35 +02:00
isard-sso@eea6982e84 Updated custom 2021-05-17 20:08:32 +02:00
sysadm Added sysadm docker & docker-compose scripts 2021-05-06 12:18:42 +02:00
.gitignore Added etherpad 2021-05-05 20:05:57 +02:00
.gitlab-ci.yml MkDocs+Gitlab setup 2021-02-22 15:43:07 +01:00
.gitmodules Added etherpad 2021-05-05 20:05:57 +02:00
Makefile Updated custom 2021-05-17 20:08:32 +02:00
README.md Updated images 2021-05-06 12:31:06 +02:00
digitaldemocratic.conf.example Added api functional 2021-05-12 21:20:33 +02:00
mkdocs.yml MkDocs+Gitlab setup 2021-02-22 15:43:07 +01:00
requirements.txt MkDocs+Gitlab setup 2021-02-22 15:43:07 +01:00

README.md

What's this

This project allows to bring up with ease a full identity provider and many apps to have an environment thought for schools and universities. The project will provide an integrated solution to handle the common environment in education:

  • Classrooms: A moodle instance with custom theme and custom plugins.
  • Cloud drive: A nextcloud instance with custom theme and custom plugins.
  • Documents: An onlyoffice instance integrated with nextcloud.
  • Web pages: A wordpress instance with custom theme and custom plugins.
  • Pad: An etherpad instance integrated with nextcloud.
  • Conferences: A BigBlueButton integrated with moodle and nextcloud. This needs an standalone host right now
  • Forms: A forms nextcloud plugins.
  • ... (some apps are there like jitsi or BigBlueButton but not fully integrated right now)

Project status

It works but as we are working on it it will have lots of improvements upcoming months. Some automatizations need to be done, specially with SAML integration and Keycloak initial personalization.

Your collaboration is wellcome! Just fork this repo and do a PR or open us an issue.

DigitalDemocratic Documentation

This documentation is writed in Markdown using MkDocs+Gitlab.

See docs directory for Markdown files or the auto-built site.

Quick start

cp digitaldemocratic.conf.example digitaldemocratic.conf

Edit digitaldemocratic.conf file variables to suit your needs.

make up

Wait till apps come up and add plugins:

make add-plugins

Extended

You can start this project in any docker & docker-compose host (any OS should work). To install those packages in your distro refer to docker & docker-compose in this documentation and in the sysadm folder you have some scripts.

Any distro should work but, if you want to use our sysadm scripts to install docker & docker compose use Debian Buster (10).

Clone and submodules

git clone https://gitlab.com/digitaldemocratic/digitaldemocratic/ cd digitaldemocratic git submodule update --init --recursive

docker

Refer to the official documentation (https://docs.docker.com/engine/install/) or use our sysadm script if you are on a Debian Buster (10).

docker-compose

Refer to the official documentation (https://docs.docker.com/compose/install/) or use our sysadm script if you are on a Debian Buster (10).

Settings

Copy digitaldemocratic.conf.example to digitaldemocratic.conf and edit to suit your needs. At least (for development) you need to adapt the DOMAIN variable to your root domain.

  • PRODUCTION: You need a multidomain dns (or redirect the multiple subdomains) to your host machine.
  • DEVELOPMENT: You can just edit your /etc/hosts and add all of them there just for testing purposes.

Subdomains

  • Keycloak: sso.<yourdomain.org>
  • FreeIPA: ipa.<yourdomain.org>
  • Api: api.<yourdomain.org>
  • Moodle: moodle.<yourdomain.org>
  • Nextcloud: nextcloud.<yourdomain.org>
  • Wordpress: wp.<yourdomain.org>
  • Onlyoffice: oof.<yourdomain.org>
  • Etherpad: pad.<yourdomain.org>

Bring the project up

make up

Then wait for the apps to come up (test by accessing the multiple subdomains) and execute:

make add-plugins

Integration

Please read the SAML_README.md in de docs folder to integrate all apps.