| 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. |
| 79 | | deb https://josm.openstreetmap.de/apt hirsute universe |
| 80 | | deb https://josm.openstreetmap.de/apt groovy universe |
| 81 | | deb https://josm.openstreetmap.de/apt focal universe |
| 82 | | deb https://josm.openstreetmap.de/apt eoan universe |
| 83 | | deb https://josm.openstreetmap.de/apt disco universe |
| 84 | | deb https://josm.openstreetmap.de/apt bionic 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 |
| 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 | | |
| 111 | | Now refresh your sources (you may need to install `sudo apt-get install apt-transport-https`) |
| 112 | | {{{#!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 |
| 129 | | The tested version of [https://packages.debian.org/stable/josm JOSM] is available under **''main''** in section **''utils''**. |
| 130 | | |
| 131 | | Please, use the [https://backports.debian.org backports repository] to get the up to date version, see [https://backports.debian.org/Instructions Instructions]. |
| 132 | | |
| 133 | | Alternatively, our own Ubuntu packages, [#Ubuntu above], work on Debian. Depending on the setup of `sudo`, some instruction will not work as "normal" user but only as `root`. |
| 134 | | |
| 135 | | Since Debian 11 (bullseye), [https://packages.debian.org/stable/josm-installer josm-installer] which downloads the .jar file from this site is an additional option for an up-to-date JOSM. |
| | 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. |
| 151 | | [=#Doubleclickonafiledoesnothing When you double-click on a jar file and nothing happens] in most cases this means Java isn't installed. |
| 152 | | |
| 153 | | 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]. |
| | 174 | When you double-click on a jar file and nothing happens in most cases this means Java isn't installed. |
| | 175 | |
| | 176 | 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 25), 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]. |
| | 177 | |
| 190 | | 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. |
| 191 | | 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`. \\ |
| 212 | | * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\` |
| 213 | | * Suggests to register josm.exe as target for the file extensions `*.osm` and `*.gpx`. |
| 214 | | * 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). |
| 215 | | * 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. |
| 218 | | 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`. |
| 219 | | Josm.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| 220 | | |
| 221 | | 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: |
| 225 | | # Write a log while starting JOSM and load OSM data |
| 226 | | josm.exe --l4j-debug https://www.osm.org/way/476702262 |
| 227 | | }}} |
| 228 | | |
| 229 | | 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]. |
| 230 | | |
| 231 | | While being a 32-bit program, josm.exe needs a 64-bit Java on a 64-bit Windows. |
| 232 | | 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 |
| 233 | | prefer JRE's. |
| 234 | | |
| | 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.**// |
