From OpenStreetMap Wiki
Jump to navigation Jump to search
JOSM 17013 screenshot en.png
Authors: Immanuel Scholz, Dirk Stöcker and other contributors.
License: GNU General Public License (free of charge)
Platforms: Windows, Linux, and macOS
Version: 18721 Changelog (2023-05-03)
Languages: Arabic, Asturian, Bulgarian, Catalan, Valencian, Czech, Danish, German, Greek, English, Canadian English, Australian English, British English, Spanish, Estonian, Basque, Finnish, French, Galician, Hungarian, Indonesian, Italian, Japanese, Khmer, Norwegian Bokmål, Dutch, Polish, Portuguese, Brazilian Portuguese, Russian, Slovak, Swedish, Turkish, Ukrainian, Uzbek, Simplified Chinese, and Traditional Chinese
Source code:
Programming language: Java

Offline highly expandable map editor

JOSM logo since August 2019

JOSM (Java OpenStreetMap Editor) is a desktop application for editing OpenStreetMap, the most powerful and complicated out of available editors. Its homepage is located at

JOSM is a feature-rich editor with an interface which can seem complex at first. Although it has a relatively steep learning curve, JOSM is popular among experienced editors thanks to its plugins and stability. There are other editors for OpenStreetMap data, such as iD and Potlatch. If you are unsure which editor to use, see the Comparison of editors article.


JOSM can be downloaded from the JOSM homepage. Many Linux distributions offer JOSM packages. See JOSM/Linux. It can be run as a local Java installation or with Java WebStart, which causes the latest version to be fetched over the Internet each time the program is run. Java version 1.8, minimum, is required to run JOSM as of 2017. The site security certificates for JOSM WebStart are invalid and will generate multiple warnings during startup, requiring the user to accept exceptions several times before the program is ready to use.

See subpage Installation for more details


JOSM screenshot, editing in Cleveland, Ohio, USA


The Guide will take you through getting started, downloading some data, basic editing and more advanced editing features. It is intended for beginners to read the guide from the beginning. This is a descriptive guide providing a simple introduction. Some details are intentionally left out.

See also


Will cover common questions.

Video Tutorials

Main article: Video tutorials#JOSM video collection

Several good tutorials have been created and shared by the Humanitarian OpenStreetMap Team via YouTube:

Help with JOSM

The JOSM Help manual should provide more exhaustive in-depth explanations of each JOSM feature. It is intended to be used as a reference manual, rather than reading from end-to-end. It is also accessible by pressing F1 within the application (context sensitive help)


Open any relation from directly in JOSM.

javascript:(function(){id=location.href.match(/www\.openstreetmap\.org\/relation\/(\d+)/);if(id!=null){''+id[1]);}else{alert('This is not a valid relation page.')}})()

(Credits to pangoSE, Eugene and The knife)

See also bookmarklets to open relations from Waymarked trails in JOSM.

JOSM Validator

Main article: JOSM/Validator

Advanced editing

JOSM is capable of advanced and efficient editing, up to and including automated edits and imports.


Originally developed by Immanuel Scholz and currently maintained by Dirk Stöcker.

See also