| 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 =|||||||| || Development || |
| 32 | | ||=Version =||= Web Start =||= Download =||= Windows =||= Apple Mac =||= Ubuntu, Debian… =||= openSUSE =||= Jar / Javadoc / Source =|| |
| 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 | | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ org.openstreetmap.josm:josm]:[[Version(tested)]] |
| 41 | | ||latest [[Version(latest)]] || \ |
| 42 | | || [/download/josm-latest.jnlp latest.jnlp] || \ |
| 43 | | || [/josm-latest.jar] || \ |
| 44 | | || || || ''[#Ubuntu see below]'' || || \ |
| 45 | | || [https://josm.openstreetmap.de/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots] || |
| 46 | | ||=older =|| || [/download/ download/] || || || [/apt/dists/ dists/] || || [https://josm.openstreetmap.de/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions] || |
| 47 | | |
| 48 | | 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. |
| 80 | | deb https://josm.openstreetmap.de/apt bionic universe |
| 81 | | deb https://josm.openstreetmap.de/apt disco universe |
| 82 | | deb https://josm.openstreetmap.de/apt eoan universe |
| 83 | | deb https://josm.openstreetmap.de/apt focal universe |
| | 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 | |
| 85 | | deb https://josm.openstreetmap.de/apt alldist universe |
| 86 | | }}} |
| 87 | | |
| 88 | | Alternatively, this can be done with the following one-liner in Ubuntu: |
| 89 | | {{{ |
| 90 | | 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 |
| 96 | | `deb https://josm.openstreetmap.de/apt VERSION universe` |
| 97 | | }}} |
| 98 | | |
| 99 | | Download and register the [[/josm-apt.key|public key]]: |
| 100 | | {{{#!sh |
| 101 | | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - |
| 102 | | }}} |
| 103 | | |
| 104 | | Now refresh your sources (you may need to install `sudo apt-get install apt-transport-https`) |
| 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 |
| 122 | | The tested version of JOSM is available under **''main''** in section **''utils''**. |
| 123 | | |
| 124 | | 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. |
| 192 | | 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). |
| 193 | | |
| 194 | | 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!) |
| 205 | | * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\` |
| 206 | | * Suggests to register josm.exe as target for the file extensions `*.osm` and `*.gpx`. |
| 207 | | * 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). |
| 208 | | * 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. |
| 211 | | 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`. |
| 212 | | Josm.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| 213 | | |
| 214 | | 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: |
| 218 | | # Write a log while starting JOSM and load OSM data |
| 219 | | josm.exe --l4j-debug https://www.osm.org/way/476702262 |
| 220 | | }}} |
| 221 | | |
| 222 | | 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]. |
| 223 | | |
| 224 | | While being a 32-bit program, josm.exe needs a 64-bit Java on a 64-bit Windows. |
| 225 | | 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 |
| 226 | | prefer JRE's. |
| 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] |
| 242 | | macOS users may use the [https://brew.sh/ homebrew] package manager to install and update their JOSM instance. Using `brew cask` eliminates the above-mentioned issues. |
| 243 | | |
| 244 | | In Terminal, run the `brew cask install josm` to install or `brew cask upgrade josm` to upgrade to the current tested version of JOSM. |
| | 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 | |
