| 9 | | == Recommended options == |
| 10 | | |
| 11 | | [[Image(source:trunk/images/openlocation.png, 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 | | [[Image(source:trunk/images/download.png, 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 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 42 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 43 | || ''[#Ubuntu see below]'' || || \ |
| | 44 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots] || |
| | 45 | ||=''**older**'' =|| || \ |
| | 46 | || [/download/ download/] || \ |
| | 47 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 48 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 49 | || [/apt/pool/universe/j/ pool/] || || \ |
| | 50 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions] || |
| | 51 | |
| | 52 | When running scripts please first check on [/latest latest], [/tested tested] or [/version all] to reduce download bandwidth. |
| 74 | | {{{ |
| 75 | | #!sh |
| 76 | | deb https://josm.openstreetmap.de/apt artful universe |
| 77 | | deb https://josm.openstreetmap.de/apt bionic universe |
| 78 | | deb https://josm.openstreetmap.de/apt disco universe |
| 79 | | deb https://josm.openstreetmap.de/apt eoan universe |
| | 81 | {{{#!sh |
| | 82 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt plucky universe |
| | 83 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt oracular universe |
| | 84 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe |
| | 85 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe |
| | 86 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe |
| | 87 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe |
| | 88 | |
| 81 | | deb https://josm.openstreetmap.de/apt alldist universe |
| 82 | | }}} |
| 83 | | |
| 84 | | Alternatively, this can be done with the following one-liner in Ubuntu: |
| 85 | | {{{ |
| 86 | | echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| | 90 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe |
| | 91 | }}} |
| | 92 | |
| | 93 | Alternatively, this can be done with the following one-liner in Ubuntu (not for Ubuntu based distributions like Linux Mint): |
| | 94 | {{{#!sh |
| | 95 | 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 |
| | 96 | }}} |
| | 97 | or for Linux Mint: |
| | 98 | {{{#!sh |
| | 99 | 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 |
| 92 | | ` |
| 93 | | deb https://josm.openstreetmap.de/apt VERSION universe |
| 94 | | ` |
| 95 | | }}} |
| 96 | | |
| 97 | | Download and register the [[/josm-apt.key|public key]]: |
| 98 | | {{{ |
| 99 | | #!sh |
| 100 | | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - |
| 101 | | }}} |
| 102 | | |
| 103 | | Now refresh your sources (you may need to install `sudo apt-get install apt-transport-https`) |
| 104 | | {{{ |
| 105 | | #!sh |
| | 105 | {{{#!sh |
| | 106 | `deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe` |
| | 107 | }}} |
| | 108 | }}} |
| | 109 | |
| | 110 | Download the [/josm-apt.key public key]: |
| | 111 | {{{#!sh |
| | 112 | # Create the directory for manually downloaded keys if it was not already created |
| | 113 | sudo mkdir -p /usr/local/share/keyrings |
| | 114 | # Download the key |
| | 115 | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg |
| | 116 | }}} |
| | 117 | In the past, instructions used `apt-key`. If the key was added to system's keyring, following line will remove it: |
| | 118 | {{{#!sh |
| | 119 | sudo apt-key del $(apt-key list | grep -B1 "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57) |
| | 120 | }}} |
| | 121 | |
| | 122 | Now refresh your sources: |
| | 123 | {{{#!sh |
| | 124 | # You may need to install ssl support for apt in advance: |
| | 125 | sudo apt-get install apt-transport-https |
| | 126 | # Refresh sources |
| 123 | | The tested version of JOSM is available under **''main''** in section **''utils''**. |
| 124 | | |
| 125 | | Please, use the [https://backports.debian.org backports repository] to get the up to date version, see [https://backports.debian.org/Instructions Instructions]. |
| | 143 | 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`. |
| | 144 | |
| | 145 | 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. \\ |
| | 146 | Please, use the [https://backports.debian.org backports repository] to get a more up-to-date version, see [https://backports.debian.org/Instructions Instructions]. This version might still be older than our own packages. |
| | 147 | |
| | 148 | 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. |
| 141 | | [=#Doubleclickonafiledoesnothing When you double-click on a jar file and nothing happens] in most cases this means Java isn't installed. |
| 142 | | |
| 143 | | 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]. |
| | 163 | When you double-click on a jar file and nothing happens in most cases this means Java isn't installed. |
| | 164 | |
| | 165 | 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]. |
| | 166 | |
| 194 | | 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). |
| 195 | | |
| 196 | | 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!) |
| | 214 | 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). |
| | 215 | |
| | 216 | 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!) |
| 207 | | * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\` |
| 208 | | * Suggests to register josm.exe as target for the file extensions `*.osm` and `*.gpx`. |
| 209 | | * 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). |
| 210 | | * Asks if the Plug-Ins Imagery offset database and Turn restrictions should be provided. |
| | 227 | * Puts two executable files `JOSM.exe` and `HWConsole.exe` in directory `%LOCALAPPDATA%\JOSM` |
| | 228 | * Registers JOSM.exe as target for the file extensions `*.osm`, `*.geojson`, `*.gpx`, `*.jos` and `*.joz`. |
| | 229 | * Places JOSM shortcut icons on the Desktop and in the Start Menu. |
| 213 | | 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`. |
| 214 | | Josm.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| 215 | | |
| 216 | | 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: |
| | 232 | When starting, JOSM.exe starts JOSM with an embedded version of Java maintained by JOSM developers, based on Azul Zulu. |
| | 233 | JOSM.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| | 234 | |
| | 235 | HWConsole.exe is similar to JOSM.exe but start JOSM while keeping open a Windows console displaying JOSM standard output (logs). |
| | 236 | |
| | 237 | JOSM.exe accepts all usual [wikitr:/Help/CommandLineOptions#Programarguments JOSM Program arguments]. See example: |
| 220 | | # Write a log while starting JOSM and load OSM data |
| 221 | | josm.exe --l4j-debug https://www.osm.org/way/476702262 |
| 222 | | }}} |
| 223 | | |
| 224 | | 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]. |
| 225 | | |
| 226 | | While being a 32-bit program, josm.exe seems to need a 64-bit Java on 64-bit Windows. |
| 227 | | |
| 228 | | === MacOS Errors ===#Macoserrors |
| 229 | | [=#MacOSErrors][=#MacOSXMountainLionErrors] |
| | 241 | # Load OSM data |
| | 242 | josm.exe https://www.osm.org/way/476702262 |
| | 243 | }}} |
| | 244 | |
| | 245 | 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 must be on a separate line. |
| | 246 | |
| | 247 | For example, to change memory allocation, open `%LOCALAPPDATA%\JOSM\app\JOSM.cfg` and add `java-options=-Xmx8192m` (for 8 GB) to a new line under the `[JavaOptions]` header. |
| | 248 | |
| | 249 | ==== Graphics ====#MicrosoftWindowsGraphics |
| | 250 | Some Windows installations have graphics driver issues (see #23784 for an example). This may exhibit symptoms such as: |
| | 251 | * Black bars in JOSM toolbars |
| | 252 | * Flickering |
| | 253 | * Other unexpected user interface issues |
| | 254 | |
| | 255 | 1. Download and install Display Driver Uninstaller (DDU, [https://github.com/Wagnard/display-drivers-uninstaller source]) from the official mirror => https://www.wagnardsoft.com/display-driver-uninstaller-DDU- |
| | 256 | 2. From the "Device Type" drop-down on the right, select "GPU". DDU will automatically detect the GPU you're using. |
| | 257 | 3. Click on "Clean and Restart" at the top. This will uninstall the graphics drivers and restart your PC. |
| | 258 | 4. Reinstall the drivers. |
| | 259 | |
| | 260 | //**WARNING: Create a backup of your PC before using DDU. Although it creates a recovery point by itself, it's ideal to make one yourself just in case.**// |
| | 261 | |
| | 262 | === macOS ===#macOS |
| | 263 | [=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors] |
| 235 | | Apple has two mechanisms to ''protect'' you from using JOSM: [https://support.apple.com//HT201940 File Quarantine] and [https://support.apple.com//HT202491 Gatekeeper]. |
| 236 | | |
| 237 | | ==== Downloaded from the internet ==== |
| 238 | | [[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. |
| 239 | | |
| 240 | | ==== Damaged ==== |
| 241 | | [[Image(#8787:damaged_josm_app.png,width=300,align=left,margin-top=-50,margin-right=30)]] |
| 242 | | |
| 243 | | 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. |
| 244 | | |
| 245 | | Open System Preferences and the 'Security & Privacy' options. Set 'Allow applications downloaded from:' to 'Anywhere'. |
| 246 | | |
| 247 | | [[Image(SecurityPrivacy.png,align=right,float=left,width=300)]] |
| 248 | | |
| 249 | | 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. |
| 250 | | |
| 251 | | {{{ |
| 252 | | sudo spctl --master-disable |
| 253 | | }}} |
| 254 | | |
| 255 | | |
| 257 | | MacOS users may choose [https://brew.sh/ homebrew] package manager as a universal way to install and update their JOSM instance. |
| 258 | | |
| 259 | | Using `brew cask` eliminates most of the above-mentioned issues. (see. [https://caskroom.github.io/]). |
| 260 | | |
| 261 | | Open Terminal and run the next commands to install or upgrade JOSM to the current tested version, respectively: |
| 262 | | |
| 263 | | {{{ |
| 264 | | brew cask install josm |
| 265 | | }}} |
| 266 | | {{{ |
| 267 | | brew cask upgrade josm |
| 268 | | }}} |
| | 270 | macOS users may use the [https://brew.sh/ homebrew] package manager to install and update their JOSM instance. |
| | 271 | |
| | 272 | In Terminal, run the `brew install --cask josm` to install or `brew upgrade --cask josm` to upgrade to the current tested version of JOSM. |
| | 273 | |
| | 274 | === Linux ===#linux |
| | 275 | ==== Arch Linux ==== |
| | 276 | Using AUR you can install [https://aur.archlinux.org/packages/openwebstart-bin openwebstart-bin]. |
| | 277 | |
| | 278 | If you use [https://archlinux.org/packages/extra/x86_64/icedtea-web/ icedtea-web] instead of the recommended openwebstart you will get an error with the newest java. java-17-openjdk is known to work, but java-22-openjdk do not. |
| | 279 | |
| | 280 | |
