linuxmuster/mrbs repository overview

This is a mrbs image for use with linuxmuster.net. (https://mrbs.sourceforge.io/⁠)

THIS IMAGE IS UNDER HEAVY DEVELOPEMENT, USE AT YOUR OWN RISK, DONT USE IN PRODUCTION

Please file any bugs and suggestions on GitHub.

• Sources: https://github.com/linuxmuster-ext-docker/linuxmuster-mrbs-image⁠

• App: https://github.com/linuxmuster-ext-docker/linuxmuster-mrbs⁠

• Supports multiple instances

• Tested with linuxmuster.net 6.2 and OpenLDAP Auth, as well as linuxmuster.net 7.0 and samba/AD

• Deployment with docker-compose

• Reverse Proxy and SSL access undecided

⁠Testing:

You need a docker host and docker-compose. A running linuxmuster.net (6.2) server with LDAPs or linuxmuster.net (7.0) with SAMBA/AD/LDAP has to be reached for authentication.

You can get the Docker App for this image on GitHub: https://github.com/linuxmuster-ext-docker/linuxmuster-mrbs⁠

Afterwards, docker-compose up -d should pull the mariadb image and the latest linuxmuster/mrbs and start them.

⁠Debugging

Useful tips for debugging:

• Set $ldap_debug = true; in the MRBS Config file (at the moment this is the default)
• You can see the logs of your app with docker-compose logs -f. You can filter easily with grep i.e. docker-compose logs -f | grep raumbuchung | grep auth to get all LDAP Auth related infos from the container named "raumbuchung".
• You can get shell access to the container with docker exec -it raumbuchung bash. There you can do an apt-get update and install whatever tools you need for debugging (an editor, for starters...).

⁠Second MRBS

You can add a second/third/... MRBS by copying the section in the docker-compose.yml file. At least you have to adjust:

• container_name
• MRBS_DB_NAME
• Config file name to get mounted as config.php.inc
• Port for external access to this instance

mrbs2:
    depends_on:
      - db
    container_name: klassenarbeiten
    restart: always
    image: linuxmuster/mrbs:latest
    environment:
        MRBS_DB_HOST: db
        MRBS_DB_PORT: 3306
        MRBS_DB_USER: mrbsdbuser
        MRBS_DB_PASSWORD: geheimDBpw
        MRBS_DB_NAME: mrbs_klassenarbeiten
        MYSQL_ROOT_PASSWORD: geheimROOTdb2010
    ports:
      - "8899:80"
    volumes:
      - ./config/klassenarbeiten.inc.php:/var/www/html/config.inc.php
      - ./dbdumps/:/var/linuxmuster-mrbs

Now you have to copy/create the config file ./config/klassenarbeiten.inc.php and adjust it to your needs.