| 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** =||= **Arch Linux** =||= **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 | || ''[#ArchLinux see below]'' || \ |
| | 38 | || [/repository/releases/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]] || |
| | 39 | ||**latest [[Version(latest)]]** || \ |
| | 40 | || [/download/josm-latest.jnlp latest.jnlp] || \ |
| | 41 | || [/josm-latest.jar] || \ |
| | 42 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 43 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 44 | || ''[#Ubuntu see below]'' || || \ |
| | 45 | || ''[#ArchLinux see below]'' || \ |
| | 46 | || [/repository/snapshots/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots] || |
| | 47 | ||=''**older**'' =|| || \ |
| | 48 | || [/download/ download/] || \ |
| | 49 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 50 | || ''see [https://github.com/openstreetmap/josm/releases releases on github] || \ |
| | 51 | || [/apt/pool/universe/j/ pool/] || || || \ |
| | 52 | || [/repository/releases/org/openstreetmap/josm/josm/ tested versions] || |
| | 53 | |
| | 54 | 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 |
| | 84 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt stonking universe |
| | 85 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt resolute universe |
| | 86 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt questing universe |
| | 87 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt plucky universe |
| | 88 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt oracular universe |
| | 89 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe |
| | 90 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe |
| | 91 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe |
| | 92 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe |
| | 93 | |
| 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 |
| | 95 | deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe |
| | 96 | }}} |
| | 97 | |
| | 98 | Alternatively, this can be done with the following one-liner in Ubuntu (not for Ubuntu based distributions like Linux Mint): |
| | 99 | {{{#!sh |
| | 100 | echo "deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(lsb_release -sc) universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| | 101 | }}} |
| | 102 | or for Linux Mint: |
| | 103 | {{{#!sh |
| | 104 | echo "deb [signed-by=/etc/apt/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 |
| | 110 | {{{#!sh |
| | 111 | `deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe` |
| | 112 | }}} |
| | 113 | }}} |
| | 114 | |
| | 115 | Download the [/josm-apt.key public key]: |
| | 116 | {{{#!sh |
| | 117 | sudo curl https://josm.openstreetmap.de/josm-apt.key -o /etc/apt/keyrings/josm-apt.gpg |
| | 118 | }}} |
| | 119 | |
| | 120 | In the past, instructions used `apt-key`. If the key was added to system's keyring, following line will remove it. This is never required, except it stops JOSM from signing packages that are NOT josm. |
| | 121 | {{{#!sh |
| | 122 | sudo apt-key del $(apt-key list | grep -B1 "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57) |
| | 123 | }}} |
| | 124 | |
| | 125 | Now refresh your sources: |
| | 126 | {{{#!sh |
| | 127 | # You may need to install ssl support for apt in advance: |
| | 128 | sudo apt-get install apt-transport-https |
| | 129 | # 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]. |
| | 146 | 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`. |
| | 147 | |
| | 148 | 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. \\ |
| | 149 | 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. |
| | 150 | |
| | 151 | 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. |
| 180 | | For some tasks, JOSM has a large appetite for memory. On the one hand, it may be necessary to configure a memory size that supports more plugins and features. On the other hand can slow machines be stabilized by restricting Javas memory use. |
| 181 | | If needed, use the [wikitr:Help/CommandLineOptions command line] to set the [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI Java Option] -Xmx…m, for example `-Xmx512m` or `-Xmx1536m`. |
| | 216 | For some tasks, JOSM has a large appetite for memory. On the one hand, it may be necessary to configure a memory size that supports more plugins and features. On the other hand can slow machines be stabilized by restricting Java's memory use. |
| | 217 | If needed, use the [wikitr:/Help/CommandLineOptions command line] to set the [https://docs.oracle.com/en/java/javase/11/tools/java.html#GUID-3B1CE181-CD30-4178-9602-230B800D4FAE__BABHDABI Java Option] -Xmx…m, for example `-Xmx512m` or `-Xmx1536m`. In Debian/Ubuntu you can edit the file `/etc/default/josm` respectively `/etc/default/josm-latest`. \\ |
| 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!) |
| | 225 | 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). |
| | 226 | |
| | 227 | 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. |
| | 238 | * Puts two executable files `JOSM.exe` and `HWConsole.exe` in directory `%LOCALAPPDATA%\JOSM` |
| | 239 | * Registers JOSM.exe as target for the file extensions `*.osm`, `*.geojson`, `*.gpx`, `*.jos` and `*.joz`. |
| | 240 | * 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: |
| | 243 | When starting, JOSM.exe starts JOSM with an embedded version of Java maintained by JOSM developers, based on Azul Zulu. |
| | 244 | JOSM.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| | 245 | |
| | 246 | HWConsole.exe is similar to JOSM.exe but start JOSM while keeping open a Windows console displaying JOSM standard output (logs). |
| | 247 | |
| | 248 | 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] |
| | 252 | # Load OSM data |
| | 253 | josm.exe https://www.osm.org/way/476702262 |
| | 254 | }}} |
| | 255 | |
| | 256 | 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. |
| | 257 | |
| | 258 | 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. |
| | 259 | |
| | 260 | ==== Graphics ====#MicrosoftWindowsGraphics |
| | 261 | Some Windows installations have graphics driver issues (see #23784 for an example). This may exhibit symptoms such as: |
| | 262 | * Black bars in JOSM toolbars |
| | 263 | * Flickering |
| | 264 | * Other unexpected user interface issues |
| | 265 | |
| | 266 | 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- |
| | 267 | 2. From the "Device Type" drop-down on the right, select "GPU". DDU will automatically detect the GPU you're using. |
| | 268 | 3. Click on "Clean and Restart" at the top. This will uninstall the graphics drivers and restart your PC. |
| | 269 | 4. Reinstall the drivers. |
| | 270 | |
| | 271 | //**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.**// |
| | 272 | |
| | 273 | === macOS ===#macOS |
| | 274 | [=#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 | | |
| 256 | | MacOS users may choose [https://brew.sh/ homebrew] package manager as a universal way to install and update their JOSM instance. |
| 257 | | |
| 258 | | Using `brew cask` eliminates most of the above-mentioned issues. (see. [https://caskroom.github.io/]). |
| 259 | | |
| 260 | | Open Terminal and run the next commands to install or upgrade JOSM to the current tested version, respectively: |
| 261 | | |
| 262 | | {{{ |
| 263 | | brew cask install josm |
| 264 | | }}} |
| 265 | | {{{ |
| 266 | | brew cask upgrade josm |
| 267 | | }}} |
| | 281 | macOS users may use the [https://brew.sh/ homebrew] package manager to install and update their JOSM instance. |
| | 282 | |
| | 283 | In Terminal, run the `brew install --cask josm` to install or `brew upgrade --cask josm` to upgrade to the current tested version of JOSM. |
| | 284 | |
| | 285 | === Linux ===#linux |
| | 286 | ==== Arch Linux ==== |
| | 287 | Using AUR you can install [https://aur.archlinux.org/packages/openwebstart-bin openwebstart-bin]. |
| | 288 | |
| | 289 | 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. |
| | 290 | |
| | 291 | |
