The BIBBOX Framework serves as a Basic Infrastructure Building Box (BIBBOX), which provides software solutions in form of apps for biobanking and bioinformatics. It provides the possibility to install apps and serve them directly towards the End-User. In the current state we are building apps to support pathologists, bioinformaticians and biobanks in their direct work as well as in Data-Management.

Please refer to the online documentation at bibbox.readthedocs.io, which includes installation instructions, a user guide and a developer guide for the BIBBOX system.

• Apps provided in the BIBBOX-Store can be easily installed with a few clicks and without any IT-knowledge.
• Installed instances can be managed in the Instances tab.
  • See the apps dashboard by clicking the gear symbol on the bottom left of the apps tile.
  • Logs of an app are accessed by clicking the book symbol in the bottom-middle of the apps tile.
• In the Activities tab each event can be expanded and contains a short descriptions about the nature of the given error.
• The log of the individual system container of the BIBBOX can be inspected in the Sys Logs tab.

Please follow the install instructions on our read the docs page - Install Bibbox(Linux) - for further details.

cd /opt
sudo mkdir bibbox
cd bibbox

sudo git clone https://github.com/bibbox/sys-bibbox.git
cd sys-bibbox

sudo docker network create bibbox-default-network
sudo bash INSTALL.sh

http://127.0.0.1:5011

http://127.0.0.1:5012

http://127.0.0.1:5013

In order to customize the login theme use the theme files in keycloak/themes/custom/login.

Simply change the html text in the frontend/src/assets/landing.html file. The changes will automatoically be loaded. After installation, this text can still be changed under the following path: /opt/bibbox/sys-bibbox/frontend/dist/sys-bibbox-client/assets/landing.html.

The BIBBOX is structured in multiple docker containers:

Proxy to enable access to the individual installed app and serves the angular frontend.

The backend is built with Flask. Flask is a Python web application framework based on the Web Server Gateway Interface (WSGI) toolkit.

Celery is a task manager which distributes tasks to worker instances. Celery usually uses a message broker such as Redis for the distribution of tasks.

Monitor to inspect celery task.

Postgres is used as database and stores activity ,and system log information, which can be accessed via the frontend.

Redis is an in-memory data structure store, used as a (NoSQL) database, cache, and message broker.

Adminer can be used to access and manage databases.

cadvisor (Container Advisor) provides resource usage and performance characteristics of the running containers.