Go to file
Evilham 0c8d40e9df Add 'dd-apps/' from commit '56472e8d26f321f74c81178f9253c0e15617e8a2'
git-subtree-dir: dd-apps
git-subtree-mainline: e65cbb5b32
git-subtree-split: 56472e8d26
2022-06-03 19:20:03 +02:00
config feat(keycloak): new json with customized values in realm and launch script in dd-ctl with keycloak config 2021-12-30 19:02:36 +01:00
custom.sample fix(custom,dd-ctl): removed unused keycloak template files 2022-02-01 12:32:31 +00:00
dd-apps Add 'dd-apps/' from commit '56472e8d26f321f74c81178f9253c0e15617e8a2' 2022-06-03 19:20:03 +02:00
dd-sso Add 'dd-sso/' from commit '53cd18d417d39500eef1d9bd4dcf05d226801e6a' 2022-06-03 19:19:59 +02:00
docs [docs] Add project management guidelines 2022-05-25 13:30:45 +02:00
sysadm corrección mantenimiento wordpress 2022-05-31 09:46:55 +02:00
.gitignore moodle configuration is automatized 2022-05-05 11:25:29 +02:00
.gitlab-ci.yml Revert "Removed:" 2022-02-09 17:09:38 +01:00
.gitmodules [dd-ctl] Switch to main branch 2022-06-03 19:07:53 +02:00
LICENSE Upload New File 2021-07-05 15:31:16 +00:00
README.md requirements added and sysadm debian script updated 2022-05-10 18:47:13 +02:00
README_en.md requirements added and sysadm debian script updated 2022-05-10 18:47:13 +02:00
README_es.md requirements added and sysadm debian script updated 2022-05-10 18:47:13 +02:00
dd-ctl [dd-ctl] Switch to in-tree directories 2022-06-03 19:12:04 +02:00
digitaldemocratic.conf.sample Merge branch 'api-jwt' into 'master' 2022-06-02 06:37:51 +00:00
mkdocs.yml Upgrade nextcloud calendar 2022-02-14 10:16:14 +01:00
requirements.txt MkDocs+Gitlab setup 2021-02-22 15:43:07 +01:00
securize_conf.sh [sysadm] [dd-ctl] improvements and simplifications 2022-05-23 13:43:00 +02:00

README_en.md

Digital Democratic

English - Català - Castellano

DD is the educational workspace generated within the framework of Xnets Democratic Digitalisation Plan. It has been created and powered by Xnet, families and promoter centres, IsardVDI, 3iPunt, Directorate for Democratic Innovation, Directorate for Digital Innovation, Commissioner for Social Economy of Barcelona City Council and Consorci dEducació de Barcelona. In collaboration with aFFaC, AirVPN, Escola Montseny, Escola Baixeras, Maadix, AirVPN and Wemcor. With the help of Miriam Carles, Cristian Ruiz, Anna Francàs, Christopher Millard.

License

DD is an software developed as part of the Democratic Digitalisation Plan by Xnet and family promoters, with the support of the Federated Associations of Families of Students of Catalonia (aFFaC).

DD software has been developed by Xnet, IsardVDI and 3iPunt as part of a pilot project of Xnet's Democratic Digitalisation Plan funded by the Directorate for Democratic Innovation, the Barcelona City Council's Digital Innovation Commissioner and the Barcelona Education Consortium, to which the participating schools have contributed.

DD can be used freely as long as this footer is included and the AGPLv3 license (https://www.gnu.org/licenses/agpl-3.0.en.html) is respected.

Credits

Pilot project of the Democratic Digitalization Plan led by Xnet and promoter families. Software created by IsardVDI and 3iPunt with the collaboration of MaadiX.net, Affac, the Barcelona City Hall and the Barcelona Education Consortium.

Project status

Project in development. We are finishing the project to shortly make it available to the community so that you can make the contributions and collaborations you want. In the coming months we will modify the code with important changes and improvements. Once it is in a more stable state we will publish it here.

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 a standalone host.
  • Forms: A forms Nextcloud plugin.
  • ... (some apps like jitsi or BigBlueButton are not fully integrated right now)

Administration interface

Now there is an administration interface that allows to easily manage users and groups and keep it in sync between applications. This is done by executing actions on the different applications apis.

To easily migrate and insert users and groups to the system there are also two provided imports:

  • From Google Admin Console as a JSON dump
  • From a CSV file

This admin interface is now in an alpha status but allows to manage users in sync between Keycloak, Moodle and Nextcloud.

Requirements

Linux distro, docker-ce, and docker-compose > 1.28

docker-compose --version
# if version < 1.28: 
pip3 install --upgrade docker-compose
docker-compose --version

If you have debian, docker and dependencies installation in sysadm/debian_docker_and_compose.sh

Quick start

cp digitaldemocratic.conf.sample digitaldemocratic.conf

Changes default passwords

./securize_conf.sh

Edit digitaldemocratic.conf file variables to suit your needs.

cp -R custom.sample custom

Edit and replace files to personalize the system.

The first time execute:

./dd-ctl repo-update

And then:

./dd-ctl all

NOTE: The SAML Auth in plugin is now automated:

  • Moodle: Not fully automated.

    1. Login to Moodle as admin via: https://moodle.<domain>/login/index.php?saml=off
    2. Go to authentication configuration: https://moodle.<domain>/admin/settings.php?section=manageauths
    3. Enable SAML2 clicking the eye.
    4. Click on configuration on SAML2
    5. Click on the Regenerate certificate button inside the form. After that go back to SAML2 configuration page.
    6. Click on the Lock certificate button.
    7. In the terminal execute the script to autoconfigure: docker exec isard-sso-admin python3 moodle_saml.py
    8. The last thing is to purge moodle cache: missing docker exec php-fpm7 script, do it through moodle web ui
  • Nextcloud: Fully automated. After finishing the make all it should be ready. In case it fails refer to isard-sso/docs.

  • Wordpress: Practically automated. After finishing the make all it should be ready and you will only need to activate the plugin. In case it fails refer to isard-sso/docs.

Instructions for post install

There is a step by step manual in: (https://digitaldemocratic.gitlab.io/digitaldemocratic).

Extended Installation

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).

Setup

Copy digitaldemocratic.conf.sample to digitaldemocratic.conf and edit to satisfy your needs. At least (for development) you should adapt the DOMAIN envvar to your root domain.

  • PRODUCTION: You'll need a multidomain dns (or redirect all the subdomains) to your server IP.
  • DEVELOPMENT: You'll have to edit your /etc/hosts and add all the required domains to your development server IP.

Subdomains

  • Keycloak: sso.<yourdomain.org>
  • Admin: admin.<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>
  • (optional) FreeIPA: ipa.<yourdomain.org>

Customization

Recursively copy the custom.sample folder to custom and edit the yaml personalization files and menu and substitute the image.

Start the project

The first time (and if you want to upgrade to the latest version later) you should execute:

./dd-ctl update-repo

And after:

./dd-ctl all

Then you can start or stop with:

./dd-ctl down
./dd-ctl up

Integration

Read the SAML_README.md file in isard-sso/docs folder to integrate all the applicactions. Now, Nextcloud and Wordpress should integrate automatically with the Keycloak.

See also Post-installation steps in Catalan.