FAQ

The source code for Oskari is open source. It is being kept flexible in order to broaden it with new components, use it with different service platforms and for changing the software libraries if needed. The UI supports multilingualism and there are already multiple languages translated. All source code is being published with MIT/EUPL licenses.

The open source code is available free of charge! Oskari saves time and money.

If you don’t want to set up Oskari installation, don’t worry you can still enjoy the ride. You can build fancy & tailored map views based on Published maps functionality in Oskari. This requires an Oskari installation that has enabled the Published map functionality. If you are registered to the Oskari site you want to use, add the map layers you need to the map and click Published maps. Follow the instructions and embedd the iframe code you get in the end to your website.

Check access rights. It might be that users with guest-role (most of the people looking at embedded maps) don't have permission to see layers included in the embedded map. See Oskari permissions LINK

Embedded maps can be tweaked to be in contact with your web site and provide more information to users using code snippets called RPC (Remote Process Call). So you can get the map to talk with your site. See the RPC example codes or follow the workshop example.

You found a bug? Can you repeat it? Yes: File a bug report at GitHub issues.

• Go to: GitHub
• Sign up
• Press New issue-button
• Include helpful information: Oskari version, browser, steps to reproduce the error
• Press Submit new issue-button

You can ask Oskari related issues by sending a query to Oskari user mailing list or chat in Oskari Gitter.

Oskari is not a software you can set up by just pushing a execute button. It is a comprehensive setup that requires understanding about server side and different software libraries. The setup is also depending on the operating system and server environment. First go to documentation and get familiar with the components. Then ask if you need assistance!

If you want to provide improvements to Oskari, here are some steps to do it:

• Open the Oskari source code in your project. Remember to follow the guidelines and How-to. Share your plans also openly through Oskari Roadmap in GitHub, so other developers know what to you are up to.
• Test and report bugs.
• Discuss and ask support.
• Remember that adding new features to Oskari main development line are discussed and decided by Oskarin PSC. If the developed feature is not suitable for the main development line, it can be added as a Community Plugin.
• Remember to update your plugins and take care that they are compatible with the versioning of the main development line. Optional: Join Joint Development Forum for Oskari and let's activate a joint development project. You'll receive support from the group and National Land Survey of Finland, were the technical support team is ready to tackle your questions and check your source code.
• Optional: Join Joint Development Forum for Oskari and let's activate a joint development project. You'll receive support from the group and National Land Survey of Finland, were the technical support team is ready to tackle your questions and check your source code.

Run mvn -N versions:set -DnewVersion={NEW-VERSION} on oskari-server root. It updates the version for oskari-server/pom.xml and all the maven modules defined in its modules-tag.