The following will show you the minimum requirements of the BIBBOX virtual machine. Please note, that installing any applications within BIBBOX will require additional resources!

  • CPU cores: 1
  • Memory: 4096 MB
  • Disk space: 20 GB

Recommended for Development

For development purposes we recommend a virtual machine with the following specifications:

  • CPU cores: 4
  • Memory: 8192 MB
  • Disk space: 100 GB


For production, please calculate the additional resources you will need, depending on the applications you are going to install within the BIBBOX.


Installation instructions

1.) Download BIBBOX image

[SERVER] - If you want to run BIBBOX on a remote server and access it from outside with a browser, download the latest image from

[LOCAL] - If you want to run BIBBOX on your local PC and just do some tests, download the latest image from

2.) Import the image into VirtualBox

If you only have access via command line, you can import the image with the following command: vboxmanage import path/to/bibbox-latest.ova

If you have a user interface on your system (e.g. it's your local PC), follow these steps:

  • Open up VirtualBox on your PC or Mac
  • CLick on File > Import Appliance...
  • Select the downloaded image and click Continue

3.) Start the machine

3a.) LOCAL

If you download the image for local testing, this machine comes with a GUI (Graphical User Interface) and is ready to be used as is.

You can just log in with username v and passwords vendetta and start using the BIBBOX by accessing it in a Browser like Firefox at the URL http://bibbox.local.domain. (please note in previous versions username / password was vmadmin / bibbox4ever)

Please be aware, that after the virtual machine has started, it takes several minutes until the BIBBOX can be accessed.


If you decided to download the server version of BIBBOX without the GUI, you will need to do some manual configuration in order to use the BIBBOX.

  1. First of all, you will need to decide for an URL on which to access the BIBBOX. For this, you or your organisation needs to provide a domain of the likes of or For this example, we assume the domain is name and we want to access the BIBBOX at
  2. If you only have access to the terminal of your server, you can start the BIBBOX virtual machine with VBoxManage startvm "BIBBOX_VM_NAME" --type headless. Otherwise just start the machine from the VirtualBox GUI and log in with user v and password vendetta.
  3. In case you are following this guide from command line, you will need to connect to the virtual machine by running ssh vmadmin@, then accept the ECDSA key fingerprint by entering yes and providing the passwort for the user v*, which is set to vendetta** by default.
  4. Now you need to make some small changes in multiple files. Please open the following files one by one with sudo nano path/to/file, change the URL to your URL (e.g. and save the files with CTRL + O and ENTER. You can exit the editor with CTRL + X.:

    • In /etc/bibbox/bibbox.cfg




    • In /etc/apache2/sites-available/000-default.conf




    • In /etc/apache2/sites-available/001-default-application-store.conf




    • In /etc/apache2/sites-available/050-liferay.conf




    • And in /etc/hosts

      change       eb3kit

      to the first part of your URL, e.g.       bibbox
  5. Finally run sudo service apache2 reload to make the changes take effect.

4.) Network configuration

If your hosting provider offers you an administration panel for managing domains and subdomains, you should use that to point to your BIBBOX. Otherwise, if you use Apache, you can do it yourself using this guide:

  1. On your server navigate to your apache configuration directory. On Linux base machines this defaults to /etc/apache2/sites-available.
  2. Create a file named 005-bibbox.conf. On Linux based systems you can do this with nano 005-bibbox.conf.
  3. Copy this proxy configuration into the file, change the ServerName, ServerAlias and the port you configured for your virtual machine. You should also change the name of the log files according to your vm name. Then save with CTRL + O and Enter.

    <VirtualHost *:80>
        ServerAlias *
        <Proxy *>
            Order deny,allow
            Allow from all
        ErrorLog ${APACHE_LOG_DIR}/bibbox.error.log
        # Possible values include: debug, info, notice, warn, error, crit,
        # alert, emerg.
        LogLevel debug
        CustomLog ${APACHE_LOG_DIR}/bibbox.access.log combined
        ProxyRequests           Off
        ProxyPreserveHost On
        ProxyPass               /api/kernels/       ws://
        ProxyPassReverse        /api/kernels/       ws://
        ProxyPass               /         
        ProxyPassReverse        /         
  4. Now navigate to the /etc/apache2/sites-enabled directory and create a symbolic link to your new proxy file with ln -s ../sites-available/005-bibbox.conf.

  5. Next reload Apache to make it recognize your changes by running service apache2 reload.
  6. You can now access the BIBBOX from anywhere in the web by calling your URL (e.g. in the browser's address bar!

alt text