Setup Oskari development environment

This document describes how to setup development environment for Oskari.


Setup Git configuration

Configure line endings:

Ignore file permissions:

git config --global core.fileMode false

1. Fetch Oskari-server source code

With commandline git:

git clone

Note! You can also download the codes in zip format from Github, but for contributing any changes to Oskari git is mandatory. Additional Maven modules can be contributed outside git though if they are compatible with the current develop/master branch, but this is not adviced.

Note! The frontend source code is already available under {jetty.base}/oskari-frontend in the Jetty bundle. To update it you can replace it with code found in

2. Build Oskari server

This will build all modules that Oskari server is composed of.

cd oskari-server
mvn clean install

3. Copy updated/relevant artifacts under {JETTY_HOME}/webapps

  • Map functionality: oskari-server/webapp-map/target/oskari-map.war
  • WFS services: oskari-server/webapp-transport/target/transport.war

4. (Optional) To update geoserver extensions:

a) Run mvn clean install in oskari-server/geoserver-ext/wps

b) Copy updated artifacts to {jetty.base}/webapps/geoserver/WEB-INF/lib:

  • oskari-server/geoserver-ext/OskariMarkFactory/target/OskariMarkFactory-[version].jar
  • oskari-server/geoserver-ext/wps/IntersectionFeatureCollection2/target/IntersectionFeatureCollection2-2.13.2.jar
  • oskari-server/geoserver-ext/wps/oskari_point_stacker/target/oskari_point_stacker-2.13.2.jar
  • oskari-server/geoserver-ext/wps/ZoneSectorFeatureCollection/target/ZoneSectorFeatureCollection-2.13.2.war

More information about git and Oskari development.

Last modified: Tue Dec 18 2018 14:34:29 GMT+0200 (EET)