# Umap

Umap is an open-source web application based on the Python framework Django. It offers you to create OpenStreetMap-based maps where you can add own information and notes with a convenient web editor.

## Server setup

### Installation

uMap can be installed with the umapAUR[broken link: archived in aur-mirror] package. The preferred database back-end is PostgreSQL which is required in combination with the postgis package.

### Configuration

Setup a postgresql database:

    $ sudo -u postgres psql

    postgres=# CREATE DATABASE umap;
    CREATE DATABASE
    postgres=# CREATE ROLE umap WITH PASSWORD 'umap' LOGIN;
    CREATE ROLE
    postgres=# GRANT ALL PRIVILEGES ON DATABASE umap to umap;
    GRANT

Copy sample uMap configuration file:

    # cp /usr/share/webapps/umap/umap/settings/local.py.sample /usr/share/webapps/umap/settings/local.py

You have to define a `SECRET_KEY` in the configuration file and define database connection settings:

    /usr/share/webapps/umap/settings/local.py

    SECRET_KEY = ''

    DATABASES = {
        'default': {
            'ENGINE': 'django.contrib.gis.db.backends.postgis',
            'NAME': 'umap',
            'USER': 'umap',
            'PASSWORD': 'umap',
        }
    }

Initialize uMap installation:

    # python2 manage.py syncdb --migrate

### Starting

Enable and start the `umap` service.

## See also

- Official documentation

Category:

- Development

Hidden category:

- Pages with broken package links