Changes between Version 116 and Version 172 of Download


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Download

    v116 v172  
    11[[TranslatedPages]]
    2 [[PageOutline(2-5,Table of Contents)]]
     2[[PageOutline(2-3,Table of Contents)]]
     3
    34= Download =
    45
    56This page provides basic JOSM installation steps and troubleshooting information.
    6 
    7 To start working with JOSM you can read the [wiki:Introduction] and the [wiki:Help] pages.
     7To start working with JOSM please see the [wikitr:/Introduction] and the [wikitr:/Help] pages.
     8And for very complex issues see [wikitr:/InstallNotes Installation Notes].
    89
    910== Recommended options ==
    10 
    11 * [[Image(source:trunk/images/openlocation.png, valign=middle, link=)]] '''Launch [/download/josm.jnlp josm.jnlp] (version [[Version(tested)]])''' - recommended version, all platforms, automatic update ([#Troubleshootingjhlplink ''.jnlp link'' doesn't work for you?])
    12 * [[Image(source:trunk/images/download.png, valign=middle, link=)]] '''Download [/josm-tested.jar josm-tested.jar] (version [[Version(tested)]])''' - all platforms ([wiki:Download#Troubleshootingjarfile not able to run a file?]). Additional memory and other tips covered at [[Help/CommandLineOptions]].
    13 
    14 [[br]]
    15 
    16 == More download options ==
    17 
    18 ''Note that [/roadmap there are fairly regular updates], so always try running a recent version (and also recent plugins)''.
    19 
    20 || ||= OS Independent =||= [https://www.java.com/en/download/faq/java_webstart.xml Web Start] =||= Windows =||= Mac OS X =||= Ubuntu, … =||= openSUSE =||
    21 ||= **tested** [[Version(tested)]] =|| **[/josm-tested.jar jar ]** || [/download/josm.jnlp jnlp] || [/download/windows/josm-setup.exe setup.exe] ([wiki:USB_Stick portable]) || [/download/macosx/josm-macosx.zip package.zip] ([#MacOSXerrors first run error]) || ''[#Ubuntu see below]'' || ''[#openSUSE see below]'' ||
    22 ||= latest [[Version(latest)]] =|| [/josm-latest.jar jar] || [/download/josm-latest.jnlp jnlp] || || || ''[#Ubuntu see below]'' || ||
    23 ||= older =|| [/download/ download/] || || || || || ||
    24 
    25 === latest or tested or webstart ===
    26 * ''tested'' - [wiki:Releases released approx. monthly and shouldn't contain severe bugs]
    27 * ''latest'' (development version) - [wiki:Releases released daily, may have more errors]
    28 * ''.jnlp link'' - If possible, use the Web Start version in order to '''automatically update'''.
    29 
    30  * Prepare a [wiki:USB_Stick USB flash drive] to use JOSM on any foreign Windows machine.
    31  * For download scripts use version check for [/latest latest] and [/tested tested] (or [/version both]) to reduce download bandwith
    32 
    33 === openSUSE repository ===#openSUSE
    34 
    35 Tested version of JOSM is available in the Application:Geo repository.
    36 
    37 First add as root user in yast or with zypper the repository (replace the version in the URL with the one you are using):
    38 {{{
    39 zypper ar -f http://download.opensuse.org/repositories/Application:/Geo/openSUSE_13.2 Application:Geo
    40 }}}
    41 
    42 Then simply install **josm** and **josm-fonts** package.
    43 
    44 === Ubuntu repository ===#Ubuntu
    45 
    46 This is a package repository primarily for Ubuntu. It should also work with other Debian based (especially Ubuntu based) distributions, but we do not actively test and maintain any distributions other than Ubuntu.
    47 [[BR]]
    48 Note: in addition to the regular procedure described below, older DEBs can be manually downloaded and clicked to be installed from the following directories:   [https://josm.openstreetmap.de/apt/pool/universe/j/josm/ for josm]  [https://josm.openstreetmap.de/apt/pool/universe/j/josm-latest/ for josm-latest] 
     11[[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **Start [/download/josm.jnlp josm.jnlp]** (newest tested version) \\
     12Recommended 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)]]) \\
     15All platforms ([#Java how to run]). \\ \\
     16
     17
     18== All download options ==#Moredownloadoptions
     19Every [/roadmap month] the team of JOSM [wikitr:/Releases releases] a **tested version** for download.
     20The MS Windows and Apple macOS variants are built on this tested version.
     21When you click on josm.jnlp to launch JOSM you will always get the newest tested version. Java's [wikitr:/InstallNotes#Webstart Web Start] is the mechanism behind this.
     22
     23[=#DevelopmentVersion]
     24Every [/log/josm/?verbose=on&limit=20 night] the build systems generate a **latest version**.
     25These versions might have severe errors. But mostly they work well, too.
     26For the latest version is also a Web Start variant available.
     27
     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] \\ ''([#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/dists/ dists/]  || ||  \
     47||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions]  ||
     48
     49When running scripts please first check on [/latest latest], [/tested tested] or [/version both] to reduce download bandwidth.
     50
     51** Strip translations **[=#Striptranslations]  \\
     52If download size is an issue, smaller files of the tested version are available. For downloads containing only English append [/josm-tested.jar?lang=en ?lang=en] to the URL. To include one translation replace `en` with the [wikitr:/TracLanguages language code] you want (lowercase first character, supported languages only). You can further reduce the file size by stripping the signing information off with appending [/josm-tested.jar?lang=en&unsigned=1 ?unsigned=1].
     53
     54
     55== Linux Repositories ==
     56=== JOSM's Debian based mainly for Ubuntu ===#Ubuntu
     57This is our own package repository primarily for Ubuntu. It should also work with other Debian based (especially Ubuntu based) distributions, but we do not actively test and maintain any distributions other than Ubuntu.
    4958
    5059The repository contains two packages:
    51  {{{josm}}}:: ''The tested version''[[br]]
    52   Replaces the package from the official Ubuntu repository.
    53  {{{josm-latest}}}:: ''The development version (nightly build)''[[br]]
    54  Can be installed parallel to the {{{josm}}} package. The default preference folder is {{{~/.josm-latest}}}.
     60* ''josm'' – Provides the tested version (stable). Replaces the package from the official repository of your distribution.
     61* ''josm-latest'' – The latest version (nightly). Can be installed in parallel to the josm package, therefore the default JOSM directories name is set to `JOSM-latest`.
     62
     63In addition to the regular procedure described below, older DEBs can be manually downloaded from the [/apt/pool/universe/j/ archives].
    5564
    5665==== Installation ====
    57 
    5866Edit the package resource list {{{/etc/apt/sources.list}}}:
    5967
    60 {{{
    61 #!sh
     68{{{#!sh
    6269sudo editor /etc/apt/sources.list
    6370}}}
     71{{{#!comment
     72### below does not work on GNU Debian systems
     73`sudo $EDITOR /etc/apt/sources.list`
     74}}}
    6475
    6576and add one of the following lines according to your Ubuntu-Version:
    6677
    67 {{{
    68 deb https://josm.openstreetmap.de/apt trusty universe
    69 deb https://josm.openstreetmap.de/apt utopic universe
    70 deb https://josm.openstreetmap.de/apt vivid universe
    71 deb https://josm.openstreetmap.de/apt wily universe
    72 deb https://josm.openstreetmap.de/apt xenial universe
    73 deb https://josm.openstreetmap.de/apt yakkety universe
    74 deb https://josm.openstreetmap.de/apt zesty universe
    75 }}}
    76 
    77 Alternatively, this can  be done with the following one-liner:
     78{{{#!sh
     79deb https://josm.openstreetmap.de/apt hirsute universe
     80deb https://josm.openstreetmap.de/apt groovy universe
     81deb https://josm.openstreetmap.de/apt focal universe
     82deb https://josm.openstreetmap.de/apt eoan universe
     83deb https://josm.openstreetmap.de/apt disco universe
     84deb https://josm.openstreetmap.de/apt bionic universe
     85
     86# For other Debian based distributions add:
     87deb https://josm.openstreetmap.de/apt alldist universe
     88}}}
     89
     90Alternatively, this can be done with the following one-liner in Ubuntu (not for Ubuntu based distributions like Linux Mint):
    7891{{{
    7992echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
    8093}}}
    81 
    82 For other Debian based distributions, add the following line:
    83 
    84 {{{
    85 deb https://josm.openstreetmap.de/apt alldist universe
    86 }}}
    87  
     94or for Linux Mint:
     95{{{
     96echo deb 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
     97}}}
    8898
    8999{{{#!comment
    90100### below did not work on all systems
    91101and add the following line:
    92 `
    93 deb https://josm.openstreetmap.de/apt VERSION universe
    94 `
    95 }}}
    96 
    97 Download and register the [[/josm-apt.key|public key]]:
     102`deb https://josm.openstreetmap.de/apt VERSION universe`
     103}}}
     104
     105Download and register the [/josm-apt.key public key]:
     106{{{#!sh
     107wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -
     108}}}
     109
     110Now refresh your sources (you may need to install `sudo apt-get install apt-transport-https`)
     111{{{#!sh
     112sudo apt-get update
     113}}}
     114and install:
     115
     116{{{#!sh
     117# You can skip this first line if these packages were not installed before.
     118sudo apt-get remove josm josm-plugins
     119
     120# For the tested version
     121sudo apt-get install josm
     122# for the development version
     123sudo apt-get install josm-latest
     124}}}
     125
     126
     127=== GNU Debian ===#GNUDebian
     128The tested version of JOSM is available under **''main''** in section **''utils''**.
     129
     130Please, use the [https://backports.debian.org backports repository] to get the up to date version, see [https://backports.debian.org/Instructions Instructions].
     131
     132Alternatively, our own Ubuntu packages, above, work on Debian. Depending on the setup of `sudo`, some instruction will not work as "normal" user but only as `root`.
     133
     134=== openSUSE  ===#Opensuse
     135[=#openSUSE]
     136The tested version of JOSM is available in the Application:Geo repository.
     137
     138First add as root user in yast or with zypper the repository (replace the version in the URL with the one you are using):
     139{{{
     140zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0 Application:Geo
     141}}}
     142
     143Then simply install ''josm'' and ''josm-fonts'' package.
     144
     145
     146== Troubleshooting ==
     147=== Java ===#Java
     148[=#Doubleclickonafiledoesnothing When you double-click on a jar file and nothing happens] in most cases this means Java isn't installed.
     149
     150JOSM 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].
     151
     152When choosing a download keep in mind:
     153 * A Java Plug-in for web browsers is **not** needed to run JOSM. Therefore results from pages like www.java.com/en/download/installed8.jsp are not relevant.
     154 * A Java variant with 64 bit is recommended for JOSM. The operating systems architecture is important for deciding between 32 bit Java or 64 bit Java. Because JOSM is **not** affected by the web browsers architecture most recommendations on this page www.java.com/en/download/faq/java_win64bit.xml are not relevant.
     155 * Avoid pages like www.java.com/en/download which intent to place Java Plug-ins in web browsers. And this is **not** important for JOSM.
     156
     157For further information visit the [InstallNotes Installation Notes] and [https://www.java.com/en/download/help/troubleshoot_java.xml troubleshooting] pages.
     158''Java'' in this section means a JRE (Java Runtime Engine) which provides a JVM (Java Virtual Machine) to run JOSM, a Java program that is developed using JDK (Java Development Kit) and sometimes launched with the JNLP (Java Network Launch Protocol aka Web Start and successor of Java Plug-ins).
     159
     160==== Testing Java ====#JavaTest
     161[=#Troubleshootingjarfile] Checks if Java is installed and why JOSM does not start (example mainly for MS Windows).
     1621. Download [/josm-tested.jar josm-tested.jar] to your desktop.
     1631. Open a Command Prompt aka Terminal
     1641. Type `cd %homepath%`⏎ and type `cd Desktop`⏎
     1651. Type `java -version `⏎ Three lines with the version data should appear. If you see something else then Java is not properly installed.
     1661. Type `java -jar josm-tested.jar`⏎. Now JOSM should run, started from the [wikitr:/Help/CommandLineOptions Command Line].
     1671. Quit JOSM.
     1681. Type `josm-tested.jar`⏎. If JOSM starts again, the Windows Explorer is ready for double clicks on jar files.
     169
     170
     171=== Web Start ===#Webstart
     172[=#Troubleshootingjhlplink]
     173If you have problems using webstart please test [#JavaTest Java] first and then run the tests described below or elsewhere [https://www.java.com/en/download/faq/java_webstart.xml Web Start issues]. Please note that webstart was dropped by Oracle starting with Java 9. In that case you will need to install [https://openwebstart.com/ OpenWebStart] separately.
     174
     175==== Testing Web Start ====#Webstarttest
     1761. Download [/download/josm.jnlp josm.jnlp] to your desktop.
     1771. Open a Terminal and move to the Desktop as above
     1781. Type `javaws josm.jnlp`⏎. This should initially download JOSM, show a security dialog and then launch JOSM.
     1791. If that fails, then type `javaws -verbose josm.jnlp`⏎. This should first show a dialog with information about the JVM and then launch JOSM.
     180
     181
     182=== Virtual Machine ===#Troubleshootingjvm
     183==== Out of memory ====
     184Nowadays manually controlling Javas memory is seldom needed because available RAM on computers has grown.
     185Wrongly chosen values can decrease JOSM performance.
     186
     187For 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.
     188If 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`.
     189Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages.
     190
     191==== VM selection ====#VMselectiononWindowsx64
     192On current versions of MS Windows by default Java is installed mainly in the `C:\Program Files\Java\` directory. Additional parts are placed in `C:\Program Files\Oracle\Java\`. There is a `.\javapath\` directory as target for the PATH environment variable. It is the home for the three virtual files `java.exe`, `javaw.exe` and `javaws.exe`. This files are symbolic links form the current Java installations.
     193
     194On older versions of 64 bit Windows sometimes the 32 bit mode JRE was additionally installed.  Also some browsers brought their own JVM with limited capabilities. In those cases a Web Start from the browser would not use your Java installation but that from the browser.
     195
     196Check 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).
     197
     198For 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!)
     199
     200Example of an edited command line for a shortcut on the windows desktop:
    98201{{{
    99202#!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`)
     203javaws.exe -J-d64 -J-Xmx2048m  josm.jnlp
     204}}}
     205
     206
     207=== Windows josm.exe ===#Mswindowswrapper
     208Using josm-setup.exe for installation on Microsoft Windows does the following:
     209 * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\`
     210 * Suggests to register josm.exe as target for the file extensions `*.osm` and `*.gpx`.
     211 * 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).
     212 * Asks if the Plug-Ins Imagery offset database and Turn restrictions should be provided.
     213 * Adds uninstall data at the appropriate places.
     214
     215When 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`.
     216Josm.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable].
     217
     218When 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:
     219
    104220{{{
    105221#!sh
    106 sudo apt-get update
    107 }}}
    108 and install:
    109  {{{josm}}}:: (You can skip the first line if you haven't installed these packages before.)
    110 {{{
    111 #!sh
    112 sudo apt-get remove josm josm-plugins
    113 sudo apt-get install josm
    114 }}}
    115 
    116  {{{josm-latest}}}::
    117 {{{
    118 #!sh
    119 sudo apt-get install josm-latest
    120 }}}
    121 
    122 == Troubleshooting ==
    123 === Troubleshooting jar file ===
    124 
    125 ==== Double click on a file does nothing ====
    126 
    127 In most cases this means Java (JVM) wasn't installed. JOSM is tested and developed with Oracle JVM, therefore it is recommended to get it from java.com site.
    128 
    129 * https://www.java.com/en/download/ - main resource, usually Installation process goes without any problems
    130 * https://www.java.com/en/download/help/download_options.xml - additional steps for all systems
    131 * https://www.java.com/en/download/help/index_installing.xml?os=All+Platforms&j=8&n=20 - please narrow down your question at their help portal about questions during installation
    132 
    133 If at least one Java was installed, refer to pages:
    134 * https://www.java.com/en/download/help/troubleshoot_java.xml - it contains most common troubleshooting questions
    135 * https://www.java.com/en/download/help/ - this page contains "Top 8 Java Issues", one of them may be yours
    136 
    137 ==== Strip down unnecessary translations in .jar ====
    138 
    139 If download size is an issue for you:
    140  * Append **?lang=…** to the download link address for both releases to strip unused translations (e.g. **?lang=de** will download JOSM in German language only).
    141  * **Note**: Use underscore to separate [[Translations|language codes]] with country code extensions, e.g. **?lang=en_GB**
    142  * Append **?unsigned=1** to strip the code signing information
    143  * When **lang** and **unsigned** are used the separation is a **&** sign like in **?lang=de&unsigned=1**
    144 
    145 10786 .jar: 10.2M[[br]]
    146 10786 .jar?lang=de: 8151k[[br]]
    147 10786 .jar?lang=de&unsigned=1: 7688k
    148 
    149 === Troubleshooting jhlp link ===
    150 
    151 Assuming, [wiki:Download#Doubleclickonafiledoesnothing JVM was already installed], read [https://www.java.com/en/download/faq/java_webstart.xml Web Start] help.
    152 
    153 === Troubleshooting JVM ===
    154 
    155 ==== Out of memory ====
    156 
    157 In more extensive edit sessions, you may get an "out of memory" error.
    158 
    159 To avoid this, the assigned memory can be increased with {{{-Xmx}}} option, see [[Help/CommandLineOptions]] for details.
    160 
    161 ==== VM selection on Windows x64 ====
    162 
    163 For Windows, beware that some browsers may install their own JRE only in 32 bit mode, but may also install their version of the Javawebstart tool somewhere else with different file associations. This may cause your JNLP to start with this alternate JRE because it runs the wrong version of Javawebstart which only supports the 32 bit VM, and sometimes is built with a restricted support for VM options and a max VM size not exceeding 256MB.
    164 
    165 Check, for example, if there's no other javawebstart in {{{\Windows\SysWow64}}}. You should not need it (the Java control panel will not detect it) and can safely delete it. Perfom cleanup and only keep the latest version of the JRE (1 for the 32-bit mode, another one for the 64-bit mode).
    166 
    167 For shortcuts created on the desktop for JNLP and running the Javawebstart launcher (from {{{\windows\system32}}}), 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!)
    168 
    169 Example of an edited commandline for the shortcut created on the windows desktop after running JOSM just once from the JNMP and exiting:
    170 {{{
    171 #!sh
    172 C:\Windows\System32\javaws.exe -J-d64 -Xmx=2048m -localfile -J-Djnlp.application.href=https://josm.openstreetmap.de/download/josm.jnlp "C:\Users\<snipped user name>\AppData\LocalLow\Sun\Java\Deployment\cache\6.0\21\7311<snipped-hex-number>7f8"
    173 }}}
    174 You don't need to change the end of the command line with the snipped parts here. Just check the path for {{{javaws.exe}}} and add options {{{-J-d64}}} for the 64-bit mode needed to work with large OSM datasets, and {{{-Xmx=2048m}}} to increase the VM size (to 2GB here).
    175 
    176 === Mac OS X errors ===
    177 [=#MacOSXMountainLionErrors]
     222# Write a log while starting JOSM and load OSM data
     223josm.exe --l4j-debug https://www.osm.org/way/476702262
     224}}}
     225
     226For 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].
     227
     228While being a 32-bit program, josm.exe needs a 64-bit Java on a 64-bit Windows.
     229Currently 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
     230prefer JRE's.
     231
     232
     233=== macOS ===#macOS
     234[=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors]
    178235{{{
    179236#!comment
    180237old section title, keeping as anchor for old links
    181238}}}
    182 [[Image(#8787:damaged_josm_app.png,align=right,margin-top=-35)]]
    183 
    184 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.
    185 
    186 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. Open System Preferences and the 'Security & Privacy' options. Set 'Allow applications downloaded from:' to 'Anywhere'. If the that radio button is missing from the Security & Privacy preferences panel, the following may be entered using a terminal window to make it appear:
    187 
    188 {{{
    189 sudo spctl --master-disable
    190 }}}
    191 
    192 === Known and open issues in JOSM ===
    193 
    194 Not closed issues about ...:
    195 * [https://josm.openstreetmap.de/query?status=!closed&type=defect&keywords=~java Java issues] - some of the bugs lead to blockers in Oracle JVM (covered at [[JavaBugs]]).
    196 * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux]
    197 * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu]
    198 * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority MacOS]
    199 * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows]
    200 
    201 == See also ==
    202 * [[Source code]]
    203 * [wiki:InstallNotes#Running how to run] - possibly outdated help page
     239
     240==== Using brew ====#brew
     241macOS users may use the [https://brew.sh/ homebrew] package manager to install and update their JOSM instance.
     242
     243In Terminal, run the `brew install --cask josm` to install or `brew upgrade --cask josm` to upgrade to the current tested version of JOSM.
     244
     245
     246=== Known issues ===
     247Not closed issues about …:
     248* [/query?status=!closed&type=defect&keywords=~java Java issues] - some of the bugs lead to blockers in Oracle JVM (covered at [wiki:JavaBugs JavaBugs]).
     249* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux]
     250* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu]
     251* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority macOS]
     252* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows]