Changes between Version 163 and Version 233 of Download
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Download
v163 v233 8 8 And for very complex issues see [wikitr:/InstallNotes Installation Notes]. 9 9 10 == Recommended options == 11 [[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **Start [/download/josm.jnlp josm.jnlp]** (newest tested version) \\ 10 == Recommended options ==#Recommendedoptions 11 [[JOSMImage(openlocation, valign=middle, link=[/download/josm.jnlp])]] **Start [/download/josm.jnlp josm.jnlp]** (newest tested version) \\ 12 12 Recommended version, all platforms, automatic update to the newest ''tested version'' monthly ([#Webstart how to start]). \\ \\ 13 13 … … 18 18 == All download options ==#Moredownloadoptions 19 19 Every [/roadmap month] the team of JOSM [wikitr:/Releases releases] a **tested version** for download. 20 The MS Windows and Apple Macvariants are built on this tested version.20 The MS Windows and Apple macOS variants are built on this tested version. 21 21 When 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 22 … … 26 26 For the latest version is also a Web Start variant available. 27 27 28 ||= =||||= **For all operating systems** =|| |||||| ||= **Development** =||29 ||=**Version** =||= **Web Start** =||= **Download** =||= **Windows** =||= **Apple Mac** =||= **Ubuntu, Debian…**=||= **openSUSE** =||= **Jar / Javadoc / Source** =||28 ||= =||||= **For all operating systems** =|| || || || || ||= **Development** =|| 29 ||=**Version** =||= **Web Start** =||= **Download** =||= **Windows** =||= **Apple macOS** =||= **Ubuntu, Debian…** =||= **openSUSE** =||= **Arch Linux** =||= **Jar / Javadoc / Source** =|| 30 30 ||**tested [[Version(tested)]]** || \ 31 31 || [/download/josm.jnlp josm.jnlp] || \ 32 32 || [/josm-tested.jar] || \ 33 || \\ [/download/windows/josm-setup.exe josm-setup.exe] \\ ''([#Mswindowswrapper see below])'' || \ 34 || \\ [/download/macosx/josm-macosx.zip package .zip] \\ ''([#Macoserrors see below])'' || \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 35 || ''[#Ubuntu see below]'' || \ 36 36 || ''[#Opensuse see below]'' || \ 37 || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]] || 38 ||**latest [[Version(latest)]]** || \ 37 || ''[#ArchLinux see below]'' || \ 38 || [/repository/releases/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]] || 39 ||**latest [[Version(latest)]]** || \ 39 40 || [/download/josm-latest.jnlp latest.jnlp] || \ 40 || [/josm-latest.jar] || || || \ 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] || \ 41 44 || ''[#Ubuntu see below]'' || || \ 42 || [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots] || 45 || ''[#ArchLinux see below]'' || \ 46 || [/repository/snapshots/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots] || 43 47 ||=''**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 49 When running scripts please first check on [/latest latest], [/tested tested] or [/version both] to reduce download bandwidth. 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. 50 55 51 56 ** Strip translations **[=#Striptranslations] \\ … … 58 63 59 64 The repository contains two packages: 60 * ''josm'' – Provides the tested version (stable). Replaces the package from the official Ubuntu repository. 61 * ''josm-latest'' – The latest version (nightly). Can be installed parallel to the josm package. The default preference folder is {{{~/.josm-latest}}}. 65 * ''josm'' – Provides the tested version (stable). Replaces the package from the official repository of your distribution. The default JOSM directories name is set to `JOSM`. 66 * ''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`. 67 Both packages provide `/etc/default/josm` respectively `/etc/default/josm-latest` as config file for [wikitr:Help/CommandLineOptions#Javaoptions java options]. 62 68 63 69 In addition to the regular procedure described below, older DEBs can be manually downloaded from the [/apt/pool/universe/j/ archives]. 64 70 65 71 ==== Installation ==== 66 Edit the package resource list {{{/etc/apt/sources.list}}}: 67 68 {{{#!sh 69 sudo editor /etc/apt/sources.list 72 Edit the package resource list `/etc/apt/sources.list.d/josm.list`: 73 {{{#!sh 74 sudo editor /etc/apt/sources.list.d/josm.list 70 75 }}} 71 76 {{{#!comment 72 77 ### below does not work on GNU Debian systems 73 `sudo $EDITOR /etc/apt/sources.list` 78 `sudo $EDITOR /etc/apt/sources.list.d/josm.list` 74 79 }}} 75 80 … … 77 82 78 83 {{{#!sh 79 deb https://josm.openstreetmap.de/apt hirsuteuniverse80 deb https://josm.openstreetmap.de/apt groovy universe81 deb https://josm.openstreetmap.de/apt focaluniverse82 deb https://josm.openstreetmap.de/apt eoanuniverse83 deb https://josm.openstreetmap.de/apt discouniverse84 deb https://josm.openstreetmap.de/apt bionic universe 84 deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt questing universe 85 deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt plucky universe 86 deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe 87 deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe 88 deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe 89 deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe 85 90 86 91 # For other Debian based distributions add: 87 deb https://josm.openstreetmap.de/apt alldist universe 92 deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe 88 93 }}} 89 94 90 95 Alternatively, this can be done with the following one-liner in Ubuntu (not for Ubuntu based distributions like Linux Mint): 91 {{{ 92 echo debhttps://josm.openstreetmap.de/apt $(lsb_release -sc) universe | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null96 {{{#!sh 97 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 93 98 }}} 94 99 or for Linux Mint: 95 {{{ 96 echo debhttps://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/null100 {{{#!sh 101 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 97 102 }}} 98 103 … … 100 105 ### below did not work on all systems 101 106 and add the following line: 102 `deb https://josm.openstreetmap.de/apt VERSION universe` 103 }}} 104 105 Download and register the [/josm-apt.key public key]: 106 {{{#!sh 107 wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - 108 }}} 109 110 Now refresh your sources (you may need to install `sudo apt-get install apt-transport-https`) 111 {{{#!sh 107 {{{#!sh 108 `deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe` 109 }}} 110 }}} 111 112 Download the [/josm-apt.key public key]: 113 {{{#!sh 114 sudo curl https://josm.openstreetmap.de/josm-apt.key -o /etc/apt/keyrings/josm-apt.gpg 115 }}} 116 117 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. 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 112 127 sudo apt-get update 113 128 }}} 129 114 130 and install: 115 116 131 {{{#!sh 117 132 # You can skip this first line if these packages were not installed before. … … 120 135 # For the tested version 121 136 sudo apt-get install josm 122 # for the development version137 # For the development version 123 138 sudo apt-get install josm-latest 124 139 }}} … … 126 141 127 142 === GNU Debian ===#GNUDebian 128 The tested version of JOSM is available under **''main''** in section **''utils''**. 129 130 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. 131 149 132 150 === openSUSE ===#Opensuse 133 [=#openSUSE] 134 The tested version of JOSM is available in the Application:Geo repository. 135 136 First add as root user in yast or with zypper the repository (replace the version in the URL with the one you are using): 137 {{{ 138 zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0 Application:Geo 151 The tested version of JOSM is available in the Application:Geo repository.[=#openSUSE] 152 153 First add as root user in yast or with zypper the repository (for Tumbleweed replace **$releasever** with **openSUSE_Tumbleweed**): 154 {{{#!sh 155 zypper ar -f 'https://download.opensuse.org/repositories/Application:/Geo/$releasever' Application:Geo 139 156 }}} 140 157 141 158 Then simply install ''josm'' and ''josm-fonts'' package. 142 159 160 === Arch Linux ===#ArchLinux 161 162 The official repository contains the `josm` [https://archlinux.org/packages/extra/any/josm/ package], which can be installed via `pacman -S josm`. 163 164 The Arch user repository (AUR) additionally contains the `josm-latest` [https://aur.archlinux.org/packages/josm-latest package] with the latest version of JOSM. 165 Use your AUR helper to install this package. 166 167 Both packages are third-party-packages and not maintained by the JOSM-team. 143 168 144 169 == Troubleshooting == 145 170 === Java ===#Java 146 [=#Doubleclickonafiledoesnothing When you double-click on a jar file and nothing happens] in most cases this means Java isn't installed. 147 148 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]. 171 When you double-click on a jar file and nothing happens in most cases this means Java isn't installed. 172 173 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]. 174 149 175 150 176 When choosing a download keep in mind: … … 153 179 * 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. 154 180 155 For further information visit the [InstallNotes Installation Notes] and [https://www.java.com/en/download/help/troubleshoot_java.xml troubleshooting] pages. 181 For further information visit the [wikitr:/InstallNotes Installation Notes] and [https://www.java.com/en/download/help/troubleshoot_java.xml troubleshooting] pages. 156 182 ''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). 157 183 … … 169 195 === Web Start ===#Webstart 170 196 [=#Troubleshootingjhlplink] 171 If 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. 197 You need to install [https://openwebstart.com/ OpenWebStart] first. It will download and run Java by itself. Please use the 64 bit (`x64`) version of OpenWebStart if you are on Microsoft Windows. The transition from Oracle WebStart to OpenWebStart is still in progress, so in case of issue please create a [/newticket new ticket] or post a comment to #17858. 198 199 You may need to update the default application for opening JNLP files if you previously used Oracle WebStart. See [https://openwebstart.com/docs/OWSGuide.html#_jnlp_file_association jnlp file association] for instructions on setting OpenWebStart as the default program for jnlp files. 172 200 173 201 ==== Testing Web Start ====#Webstarttest … … 184 212 185 213 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. 186 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`.214 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`. \\ 187 215 Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages. 188 216 … … 194 222 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 223 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!)224 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!) 197 225 198 226 Example of an edited command line for a shortcut on the windows desktop: … … 202 230 }}} 203 231 204 205 === Windowsjosm.exe ===#Mswindowswrapper232 === Microsoft Windows ===#MSWindows 233 ==== josm.exe ====#Mswindowswrapper 206 234 Using josm-setup.exe for installation on Microsoft Windows does the following: 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. 235 * Puts two executable files `JOSM.exe` and `HWConsole.exe` in directory `%LOCALAPPDATA%\JOSM` 236 * Registers JOSM.exe as target for the file extensions `*.osm`, `*.geojson`, `*.gpx`, `*.jos` and `*.joz`. 237 * Places JOSM shortcut icons on the Desktop and in the Start Menu. 211 238 * Adds uninstall data at the appropriate places. 212 239 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: 240 When starting, JOSM.exe starts JOSM with an embedded version of Java maintained by JOSM developers, based on Azul Zulu. 241 JOSM.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. 242 243 HWConsole.exe is similar to JOSM.exe but start JOSM while keeping open a Windows console displaying JOSM standard output (logs). 244 245 JOSM.exe accepts all usual [wikitr:/Help/CommandLineOptions#Programarguments JOSM Program arguments]. See example: 217 246 218 247 {{{ 219 248 #!sh 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 needs a 64-bit Java on a 64-bit Windows. 227 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 228 prefer JRE's. 229 230 231 === macOS Errors ===#Macoserrors 232 [=#MacOSErrors][=#MacOSXMountainLionErrors] 249 # Load OSM data 250 josm.exe https://www.osm.org/way/476702262 251 }}} 252 253 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. 254 255 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. 256 257 ==== Graphics ====#MicrosoftWindowsGraphics 258 Some Windows installations have graphics driver issues (see #23784 for an example). This may exhibit symptoms such as: 259 * Black bars in JOSM toolbars 260 * Flickering 261 * Other unexpected user interface issues 262 263 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- 264 2. From the "Device Type" drop-down on the right, select "GPU". DDU will automatically detect the GPU you're using. 265 3. Click on "Clean and Restart" at the top. This will uninstall the graphics drivers and restart your PC. 266 4. Reinstall the drivers. 267 268 //**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.**// 269 270 === macOS ===#macOS 271 [=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors] 233 272 {{{ 234 273 #!comment … … 236 275 }}} 237 276 238 [[Image(josm_1st_run.png,width=400,align=right,link=)]]239 240 ==== Downloaded from the internet ====241 On the first run of JOSM, you will get a message saying "'JOSM.app' is an application downloaded from the internet." **Right-click or ctrl-click on JOSM.app** or josm.jnlp and select 'open'. You will see the same message, but this time with an option to "Open".242 243 277 ==== Using brew ====#brew 244 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. 245 246 In Terminal, run the `brew cask install josm` to install or `brew cask upgrade josm` to upgrade to the current tested version of JOSM. 278 macOS users may use the [https://brew.sh/ homebrew] package manager to install and update their JOSM instance. 279 280 In Terminal, run the `brew install --cask josm` to install or `brew upgrade --cask josm` to upgrade to the current tested version of JOSM. 281 282 === Linux ===#linux 283 ==== Arch Linux ==== 284 Using AUR you can install [https://aur.archlinux.org/packages/openwebstart-bin openwebstart-bin]. 285 286 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. 247 287 248 288
