| 9 | | == Recommended options == |
| 10 | | |
| 11 | | [[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **Start [/download/josm.jnlp josm.jnlp]** (newest tested version) [[br]] |
| 12 | | Recommended version, all platforms, automatic update to the newest ''tested version'' monthly ([#Webstart how to start]). [[br]] |
| 13 | | [[br]] |
| 14 | | |
| 15 | | [[JOSMImage(download, valign=middle, link=[/josm-tested.jar])]] **Download [/josm-tested.jar josm-tested.jar]** (tested version [[Version(tested)]]) [[br]] |
| 16 | | All platforms ([#Java how to run]). [[br]] |
| 17 | | [[br]] |
| | 10 | == Recommended options ==#Recommendedoptions |
| | 11 | [[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **Start [/download/josm.jnlp josm.jnlp]** (newest tested version) \\ |
| | 12 | Recommended version, all platforms, automatic update to the newest ''tested version'' monthly ([#Webstart how to start]). \\ \\ |
| | 13 | |
| | 14 | [[JOSMImage(download, valign=middle, link=[/josm-tested.jar])]] **Download [/josm-tested.jar josm-tested.jar]** (tested version [[Version(tested)]]) \\ |
| | 15 | All platforms ([#Java how to run]). \\ \\ |
| | 16 | |
| 30 | | |
| 31 | | ||= =||||= For all operating systems =|||||||||| |
| 32 | | ||=Version =||= Web Start =||= Download =||= Windows =||= Apple Mac =||= Ubuntu, Debian… =||= openSUSE =|| |
| 33 | | ||tested [[Version(tested)]] || \ |
| 34 | | || [/download/josm.jnlp josm.jnlp] || \ |
| 35 | | || [/josm-tested.jar] || \ |
| 36 | | || [[br]] [/download/windows/josm-setup.exe setup.exe] [[br]]''([#Mswindowswrapper see below])'' || \ |
| 37 | | || [[br]] [/download/macosx/josm-macosx.zip package.zip] [[br]]''([#Macoserrors see below])'' || \ |
| 38 | | || ''[#Ubuntu see below]'' || \ |
| 39 | | || ''[#Opensuse see below]'' || |
| 40 | | ||latest [[Version(latest)]] || \ |
| 41 | | || [/download/josm-latest.jnlp latest.jnlp] || \ |
| 42 | | || [/josm-latest.jar] || \ |
| 43 | | || || || ''[#Ubuntu see below]'' || || |
| 44 | | ||=older =|| || [/download/ download/] || || || [/apt/dists/ dists/] || || |
| 45 | | |
| 46 | | When running scripts please first check on [/latest latest], [/tested tested] or [/version both] to reduce download bandwidth. |
| | 28 | ||= =||||= **For all operating systems** =|||||||| ||= **Development** =|| |
| | 29 | ||=**Version** =||= **Web Start** =||= **Download** =||= **Windows** =||= **Apple macOS** =||= **Ubuntu, Debian…** =||= **openSUSE** =||= **Jar / Javadoc / Source** =|| |
| | 30 | ||**tested [[Version(tested)]]** || \ |
| | 31 | || [/download/josm.jnlp josm.jnlp] || \ |
| | 32 | || [/josm-tested.jar] || \ |
| | 33 | || \\ [/download/windows/josm-setup.exe josm-setup.exe] \\ [/download/windows/josm-setup.msi josm-setup.msi] \\ [https://apps.microsoft.com/store/detail/josm/XPFCG1GV0WWGZX Microsoft Store]\\ ''([#Mswindowswrapper see below])'' || \ |
| | 34 | || \\ [/download/macosx/josm-macosx.zip JOSM macOS .zip package] \\ ''or ([#macOS homebrew])'' || \ |
| | 35 | || ''[#Ubuntu see below]'' || \ |
| | 36 | || ''[#Opensuse see below]'' || \ |
| | 37 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]] || |
| | 38 | ||**latest [[Version(latest)]]** || \ |
| | 39 | || [/download/josm-latest.jnlp latest.jnlp] || \ |
| | 40 | || [/josm-latest.jar] || || || \ |
| | 41 | || ''[#Ubuntu see below]'' || || \ |
| | 42 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots] || |
| | 43 | ||=''**older**'' =|| || \ |
| | 44 | || [/download/ download/] || || \ |
| | 45 | || [https://github.com/openstreetmap/josm/releases automatic JOSM.app builds] || \ |
| | 46 | || [/apt/pool/universe/j/ pool/] || || \ |
| | 47 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions] || |
| | 48 | |
| | 49 | When running scripts please first check on [/latest latest], [/tested tested] or [/version all] to reduce download bandwidth. |
| 78 | | deb https://josm.openstreetmap.de/apt artful universe |
| 79 | | deb https://josm.openstreetmap.de/apt bionic universe |
| 80 | | deb https://josm.openstreetmap.de/apt disco universe |
| 81 | | deb https://josm.openstreetmap.de/apt eoan universe |
| | 79 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe |
| | 80 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt mantic universe |
| | 81 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt lunar universe |
| | 82 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe |
| | 83 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe |
| | 84 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe |
| | 85 | |
| 83 | | deb https://josm.openstreetmap.de/apt alldist universe |
| 84 | | }}} |
| 85 | | |
| 86 | | Alternatively, this can be done with the following one-liner in Ubuntu: |
| 87 | | {{{ |
| 88 | | echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| | 87 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe |
| | 88 | }}} |
| | 89 | |
| | 90 | Alternatively, this can be done with the following one-liner in Ubuntu (not for Ubuntu based distributions like Linux Mint): |
| | 91 | {{{#!sh |
| | 92 | echo "deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(lsb_release -sc) universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| | 93 | }}} |
| | 94 | or for Linux Mint: |
| | 95 | {{{#!sh |
| | 96 | echo "deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(grep ^DISTRIB_CODENAME= /etc/upstream-release/lsb-release| awk -F = '{print $(2)}') universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| 94 | | `deb https://josm.openstreetmap.de/apt VERSION universe` |
| 95 | | }}} |
| 96 | | |
| 97 | | Download and register the [[/josm-apt.key|public key]]: |
| 98 | | {{{#!sh |
| 99 | | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - |
| 100 | | }}} |
| 101 | | |
| 102 | | Now refresh your sources (you may need to install `sudo apt-get install apt-transport-https`) |
| 103 | | {{{#!sh |
| | 102 | {{{#!sh |
| | 103 | `deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe` |
| | 104 | }}} |
| | 105 | }}} |
| | 106 | |
| | 107 | Download the [/josm-apt.key public key]: |
| | 108 | {{{#!sh |
| | 109 | # Create the directory for manually downloaded keys if it was not already created |
| | 110 | sudo mkdir -p /usr/local/share/keyrings |
| | 111 | # Download the key |
| | 112 | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg |
| | 113 | }}} |
| | 114 | In the past, instructions used `apt-key`. If the key was added to system's keyring, following line will remove it: |
| | 115 | {{{#!sh |
| | 116 | sudo apt-key del $(apt-key list | grep -B1 "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57) |
| | 117 | }}} |
| | 118 | |
| | 119 | Now refresh your sources: |
| | 120 | {{{#!sh |
| | 121 | # You may need to install ssl support for apt in advance: |
| | 122 | sudo apt-get install apt-transport-https |
| | 123 | # Refresh sources |
| 120 | | The tested version of JOSM is available under **''main''** in section **''utils''**. |
| 121 | | |
| 122 | | Please, use the [https://backports.debian.org backports repository] to get the up to date version, see [https://backports.debian.org/Instructions Instructions]. |
| | 140 | Our own Ubuntu packages, [#Ubuntu above], work on Debian and we recommend to use them. Depending on the setup of `sudo`, some instruction will not work as "normal" user but only as `root`. |
| | 141 | |
| | 142 | Since Debian 11 (bullseye) the [https://packages.debian.org/stable/josm-installer josm-installer] is available under **''main''** in section **''utils''**. It downloads the current .jar file from this site and updates it if necessary. |
| | 143 | |
| | 144 | The tested version of [https://packages.debian.org/stable/josm JOSM] is available under **''main''** in section **''utils''**, but the version is usually quite old. \\ |
| | 145 | Please, use the [https://backports.debian.org backports repository] to get a more up-to-date version, see [https://backports.debian.org/Instructions Instructions]. Still this version might be quite old. |
| 138 | | [=#Doubleclickonafiledoesnothing When you double-click on a jar file and nothing happens] in most cases this means Java isn't installed. |
| 139 | | |
| 140 | | JOSM is tested with Oracles variant, so we recommend to get Java from their pages for [https://www.java.com/download/manual.jsp manual] downloads or [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html intermediate] versions. But first give the Java already distributed with the operating system a try, [https://en.wikipedia.org/wiki/OpenJDK for example]. |
| | 160 | When you double-click on a jar file and nothing happens in most cases this means Java isn't installed. |
| | 161 | |
| | 162 | JOSM now recommends [https://www.azul.com/downloads/?version=java-21-lts&package=jdk-fx#zulu Azul] or [https://bell-sw.com/pages/downloads/?package=jre-full#mn Bellsoft Liberica] JDK's. Generally speaking, the current Java LTS should be preferred (at time of writing, that would be Java 17), but Java 11 will work. See the [source:/trunk/README README] for current recommendations. But first give the Java already distributed with the operating system a try, [https://en.wikipedia.org/wiki/OpenJDK for example]. |
| | 163 | |
| 191 | | Check that there's no other javawebstart in {{{\Windows\SysWow64}}}. The Java control panel will not detect it and you can safely delete it. Perform cleanup and only keep the latest versions of each JRE (One or the 32-bit mode, another one for the 64-bit mode). |
| 192 | | |
| 193 | | For shortcuts created on the desktop for JNLP and running the Javawebstart launcher , make sure to pass VM parameters prefixed with -J and no intermediate space before the VM option. If you have installed both the 32-bit and 64-bit version, you should pass the option "{{{-d64}}}" if you want to select the preferred 64-bit VM. Note that some Oracle documentation pages indicate the option "-D64" with the incorrect capitalization!) |
| | 211 | Check that there's no other javawebstart in `\Windows\SysWow64`. The Java control panel will not detect it and you can safely delete it. Perform cleanup and only keep the latest versions of each JRE (One or the 32-bit mode, another one for the 64-bit mode). |
| | 212 | |
| | 213 | For shortcuts created on the desktop for JNLP and running the Javawebstart launcher , make sure to pass VM parameters prefixed with -J and no intermediate space before the VM option. If you have installed both the 32-bit and 64-bit version, you should pass the option "`-d64`" if you want to select the preferred 64-bit VM. Note that some Oracle documentation pages indicate the option "-D64" with the incorrect capitalization!) |
| 204 | | * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\` |
| 205 | | * Suggests to register josm.exe as target for the file extensions `*.osm` and `*.gpx`. |
| 206 | | * Suggests to place JOSM shortcut icons on the Desktop and in the Start Menu (Currently they are placed for an admin only and can be copied from there, #11398). |
| 207 | | * Asks if the Plug-Ins Imagery offset database and Turn restrictions should be provided. |
| | 224 | * Puts two executable files `JOSM.exe` and `HWConsole.exe` in directory `%LOCALAPPDATA%\JOSM` |
| | 225 | * Registers JOSM.exe as target for the file extensions `*.osm`, `*.geojson`, `*.gpx`, `*.jos` and `*.joz`. |
| | 226 | * Places JOSM shortcut icons on the Desktop and in the Start Menu. |
| 210 | | When starting, josm.exe searches its directory for the jar file and runs the command `\path\to\javaw.exe -Xms128m -Xmx1024m -jar \path\to\josm-tested.jar`. |
| 211 | | Josm.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| 212 | | |
| 213 | | When josm.exe finds the argument `--l4j-debug`, it writes the log file `launch4j.log` into the current directory if that is writeable. Some other [http://launch4j.sourceforge.net/docs.html#Runtime_options options] are possible and all usual [wikitr:/Help/CommandLineOptions#Programarguments JOSM Program arguments] too. See example: |
| | 229 | When starting, JOSM.exe starts JOSM with an embedded version of Java maintained by JOSM developers, based on Azul Zulu. |
| | 230 | JOSM.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| | 231 | |
| | 232 | HWConsole.exe is similar to JOSM.exe but start JOSM while keeping open a Windows console displaying JOSM standard output (logs). |
| | 233 | |
| | 234 | JOSM.exe accepts all usual [wikitr:/Help/CommandLineOptions#Programarguments JOSM Program arguments]. See example: |
| 217 | | # Write a log while starting JOSM and load OSM data |
| 218 | | josm.exe --l4j-debug https://www.osm.org/way/476702262 |
| 219 | | }}} |
| 220 | | |
| 221 | | For giving [wikitr:Help/CommandLineOptions#Javaoptions Java options] to the Java VM josm.exe uses the optional file `josm.l4j.ini` in its directory. In this file each option needs a separate line and comments are possible, see [http://launch4j.sourceforge.net/docs.html#Additional_jvm_options Additional JVM options]. |
| 222 | | |
| 223 | | While being a 32-bit program, josm.exe needs a 64-bit Java on a 64-bit Windows. |
| 224 | | Currently josm.exe is [/browser/josm/trunk/windows/launch4j.xml configured] to search for java in the [https://sourceforge.net/p/launch4j/feature-requests/127/ registry only] and to |
| 225 | | prefer JRE's. |
| 226 | | |
| 227 | | === MacOS Errors ===#Macoserrors |
| 228 | | [=#MacOSErrors][=#MacOSXMountainLionErrors] |
| | 238 | # Load OSM data |
| | 239 | josm.exe https://www.osm.org/way/476702262 |
| | 240 | }}} |
| | 241 | |
| | 242 | For giving [wikitr:/Help/CommandLineOptions#Javaoptions Java options] to the Java VM JOSM.exe uses the configuration file `JOSM.cfg` in its app sub-directory. In this file each option needs a separate line. |
| | 243 | |
| | 244 | === macOS ===#macOS |
| | 245 | [=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors] |
| 234 | | Apple has two mechanisms to ''protect'' you from using JOSM: [https://support.apple.com//HT201940 File Quarantine] and [https://support.apple.com//HT202491 Gatekeeper]. |
| 235 | | |
| 236 | | ==== Downloaded from the internet ==== |
| 237 | | [[Image(josm_1st_run.png,width=320,align=right,float=left)]] If you get an error saying "'JOSM.app' is an application downloaded from the internet." you can bypass this by **right-clicking on JOSM.app** or josm.jnlp and selecting 'open'. You should then see the same message but this time with an option to "Open" regardless. This is only necessary on the first run of JOSM. |
| 238 | | |
| 239 | | ==== Damaged ==== |
| 240 | | [[Image(#8787:damaged_josm_app.png,width=300,align=left,margin-top=-50,margin-right=30)]] |
| 241 | | |
| 242 | | If you get an error saying "'JOSM.app' is damaged and can't be opened. You should move it to the Trash", then you need to temporarily disable Gatekeeper. |
| 243 | | |
| 244 | | Open System Preferences and the 'Security & Privacy' options. Set 'Allow applications downloaded from:' to 'Anywhere'. |
| 245 | | |
| 246 | | [[Image(SecurityPrivacy.png,align=right,float=left,width=300)]] |
| 247 | | |
| 248 | | If that radio button is missing from the Security & Privacy preferences panel, open the Terminal window. The following command may become the radio button to appear. |
| 249 | | |
| 250 | | {{{ |
| 251 | | sudo spctl --master-disable |
| 252 | | }}} |
| 253 | | |
| 254 | | |
