Skip to content
Site visible in
Branch: master
Clone or download
Latest commit e555194 Nov 28, 2019

Sample server-extension for Oskari

This is a template that can be used as base for extending and customizing oskari-server.

Click the "Use this template" button on the repository to create a copy of the files under your username and start customizing it.

This application can be seen in

Modifying the initial application setup:

Initial content and configuration on the database is created with Flyway-scripts under:

  • app-resources/src/main/java/flyway/example
  • app-resources/src/main/resources/flyway/example

These migrations are run in version order and changing them will change the application that is created on an empty database.

You can also rename the "example" folder to something more appropriate for your app. Note that this line in will be used to find the scripts so rename "example" on it as well:

db.additional.modules=myplaces, userlayer, example

Layers can be configured in json:


And referenced in app setups like in (the selectedLayers key):


Compile with:

mvn clean install

Replace oskari-map.war under {jetty.home}/webapps/ with the one created under webapp-map/target

Note! If you modify the order of "views" (app setups) you might need to modify

# default view is the first app setup (value is the database id)

# publish template is the second app setup

# "native" projection to store the myplaces etc user-generated content:

To enable end-user registration configure these (more information at


Note! We will be updating existing Flyway-migrations in this repository to match any change we see would be an improvement on the template. This is something that you should NOT do on your customization since running modified migrations on an existing database will trigger an error. This is only done to keep the template more simple.

Reporting issues

All Oskari-related issues should be reported here:


This work is dual-licensed under MIT and EUPL v1.1 (any language version applies, English version is included in You can choose between one of them if you use this work.

SPDX-License-Identifier: MIT OR EUPL-1.1

Copyright (c) 2014-present National Land Survey of Finland

You can’t perform that action at this time.