Installation on Ubuntu and Debian

The following Installation manual describes the neccessary steps on a recent Ubuntu or Debian system. We assume that Apache 2.4 is running on the system. A documentation for Apache 2.2 is added at the end of the document.

Please take note of the system requirements, where you can also find the Download links to Mapbender3.

There are also the neccessary components listed that you can install like this:

sudo apt-get install php5 php5-pgsql php5-gd php5-curl php5-cli php5-sqlite sqlite php-apc php5-intl curl openssl

Load the Apache rewrite-module:

sudo a2enmod rewrite

Configure the Apache Alias. We assume that Mapbender3 is unzipped into /var/www/mapbender3 (see the System Requirements and Download chapter for details). You can easily unpack Mapbender3 to a different directory and only adjust the following file to refer to the right directory.

Create the file /etc/apache2/sites-available/mapbender3.conf with the content below.

Alias /mapbender3 /var/www/mapbender3/web/
<Directory /var/www/mapbender3/web/>
 Options MultiViews FollowSymLinks
 DirectoryIndex app.php
 Require all granted

 RewriteEngine On
 RewriteBase /mapbender3/
 RewriteCond %{ENV:REDIRECT_STATUS} ^$
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteCond %{REQUEST_FILENAME} !-d
 RewriteRule ^(.*)$ app.php/$1 [PT,L,QSA]

Activate the site afterwards with

Reload your Apache server.

service apache2 reload


Check that the Alias is working:

Open Symfony´s Welcome Script config.php. This script checks whether all necessary components are installed and configurations are done. If there are still problems, you should fix them.


Configuration of Mapbender3

Set the write permission for user (u), group (g) and others (a) and rights. Assign the files to the Apache user (www-data).

sudo chmod -R ugo+r /var/www/mapbender3
sudo chown -R www-data:www-data /var/www/mapbender3
sudo chmod -R ug+w /var/www/mapbender3/web/uploads

Adapt the Mapbender3 configuration file parameters.yml (app/config/parameters.yml) and define the database you want to create. Further information is available in the chapter Configuring the database.

database_driver:   pdo_pgsql
database_host:     localhost
database_port:     5432
database_name:     mapbender3
database_path:     ~
database_user:     postgres
database_password: secret

Run the app/console commands. You find detailed information for this commands in the chapter Details of the configuration of Mapbender3.

cd /var/www/mapbender3
app/console doctrine:database:create
app/console doctrine:schema:create
app/console assets:install web
app/console fom:user:resetroot
app/console doctrine:fixtures:load --fixtures=./mapbender/src/Mapbender/CoreBundle/DataFixtures/ORM/Epsg/ --append
app/console doctrine:fixtures:load --fixtures=./mapbender/src/Mapbender/CoreBundle/DataFixtures/ORM/Application/ --append

Installation of Mapbender3 is done.

Check the config.php again:

You have to set write permission to app/cache, app/logs and web/uploads.

sudo chmod -R ug+w /var/www/mapbender3/app/cache
sudo chmod -R ug+w /var/www/mapbender3/app/logs
sudo chmod -R ug+w /var/www/mapbender3/web/uploads

You can start using Mapbender3 now.

Notice: Click on the Mapbender3 logo to get to the login page. Log in with the new user you created.

You can open the developer mode when you run app_dev.php: http://localhost/mapbender3/app_dev.php

To learn more about Mapbender3 have a look at the Mapbender3 Quickstart.

Instructions for Apache 2.2

Unlike Apache 2.4 you have to place the mapbender3.conf file for Apache 2.2 into the directory /etc/apache2/conf.d/

Apache 2.2 configuration:

ALIAS /mapbender3 /var/www/mapbender3/web/
<Directory /var/www/mapbender3/web/>
  Options MultiViews
  DirectoryIndex app.php
  Order allow,deny
  Allow from all

Please note that Apache 2.2 uses different Access Control directives than Apache 2.4 (Allow from all).