- This is the standard installation guide. For a detailed description please refer to the Manual Installation page.
- If you want to upgrade a running version of Mapbender please refer to the Update page.
Instructions, path names and so on refer to a Debian Linux operating system unless otherwise specified.
Mapbender requires the following components, carfeully read the instructions for the configuration process of each package:
- Webserver ( Apache httpd, MS IIS)
- Database ( PostgreSQL >= 8.x with PostGIS)
- PHP (scripting language, version > 5.1.x)
- php5-curl (if you want to use cURL - have a look in mapbender.conf)
Check the required Manual_Installation#PHP_Configuration PHP configuration if you use Mapbender for the first time becasue it requires everal settings to operate smoothly. Make sure that you follow the installation instructions for your operating system individually as the paths to files will vary on your systems.
- Learn more about the Client capabilities to see what is required on the client side of things.
- Please consider to customize the main configuration file mapbender.conf and make sure that this file is backed up.
- If you want to use Mapbender in an i18n (Internationalization) environment, you need to install php-gettext, see gettext.
- take care - Suhosin can effect Mapbender administration and block requests
The install script creates the Mapbender database and loads the initial content. It also compiles the Mapbender.mo files to implement multi language support (i18n). The install script install.sh (install.bat for Windows systems) is located in the directory:
You have to run the script on a command line interface (Shell or DOS prompt) in that directory so that the script can find all related directories and files.
You will be asked to input information, make sure that you have them ready. After requesting this information the installation will proceed automatically. Depending on your system and the connected database this may take a while.
Before running this script make sure that:
- you have the credentials og a PostgreSQL user with superuser privileges
- you know under which account the web server is running (on Debian Linux typically www-data)
- you know to which group the web server user belongs (on Debian Linux typically www-data)
You can also give all arguments on the commandline:
./install.sh <HOST> <PORT> <DBNAME> <DBTEMPLATE> <DBUSER>
./install.sh localhost 5432 mapbender_data template0 postgres
Enter the name, IP or FQDN of the server running the PostgreSQL database (default: localhost).
The default database port of PostgreSQL is 5432. Only change this if your database cannot be accessed through port 5432.
Enter a name for your database. You can use any name following the PostgreSQL conventions (no capitals, no special characters, etc.). This database will contain the credentials of all your users, the metadata of the OWS services and the configurations of your applications.
PostgreSQL can use a template to create a new database (default template0). It is recommended to create a postgis_template containing the PostGIS extension and use this template for your Mapbender database. Mapbender needs PostGIS functions for some functionality.
You need a database user with superuser privileges to create the Mapbender database. For security reasons make sure that you remove superuser permissions after installation.
Database sample configuration:
version: pgsql encoding: UTF-8 postgres template: postgis_template db host: localhost db port: 5432 dbname: mapbender_db user: mapbender
Testing and Debugging
- You can test (and also debug) your Mapbender installation using the mapbender_setup.php
- Check the Mapbender log files