Changes between Version 183 and Version 213 of Download


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

Legend:

Unmodified
Added
Removed
Modified

  • Download

    v183 v213  
    3131||  [/download/josm.jnlp josm.jnlp]  ||  \
    3232||  [/josm-tested.jar]  ||  \
    33 ||  \\ [/download/windows/josm-setup.exe josm-setup.exe] \\ ''([#Mswindowswrapper 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])''  ||  \
    3434||  \\ [/download/macosx/josm-macosx.zip JOSM macOS .zip package] \\ ''or ([#macOS homebrew])''  ||  \
    3535||  ''[#Ubuntu see below]''  ||  \
    … …  
    4444||  [/download/ download/]  || ||  \
    4545||  [https://github.com/openstreetmap/josm/releases automatic JOSM.app builds]  ||  \
    46 ||  [/apt/dists/ dists/]  || ||  \
     46||  [/apt/pool/universe/j/ pool/]  || ||  \
    4747||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions]  ||
    4848
    … …  
    5858
    5959The repository contains two packages:
    60 * ''josm'' – Provides the tested version (stable). Replaces the package from the official repository of your distribution.
     60* ''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`.
    6161* ''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`.
     62Both packages provide `/etc/default/josm` respectively `/etc/default/josm-latest` as config file for [wikitr:Help/CommandLineOptions#Javaoptions java options].
    6263
    6364In addition to the regular procedure described below, older DEBs can be manually downloaded from the [/apt/pool/universe/j/ archives].
    6465
    6566==== Installation ====
    66 Edit the package resource list `/etc/apt/sources.list`:
    67 
    68 {{{#!sh
    69 sudo editor /etc/apt/sources.list
     67Edit the package resource list `/etc/apt/sources.list.d/josm.list`:
     68{{{#!sh
     69sudo editor /etc/apt/sources.list.d/josm.list
    7070}}}
    7171{{{#!comment
    7272### below does not work on GNU Debian systems
    73 `sudo $EDITOR /etc/apt/sources.list`
     73`sudo $EDITOR /etc/apt/sources.list.d/josm.list`
    7474}}}
    7575
    … …  
    7777
    7878{{{#!sh
    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
     79deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe
     80deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt mantic universe
     81deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt lunar universe
     82deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe
     83deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe
     84deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe
    8585
    8686# For other Debian based distributions add:
    87 deb https://josm.openstreetmap.de/apt alldist universe
     87deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe
    8888}}}
    8989
    9090Alternatively, this can be done with the following one-liner in Ubuntu (not for Ubuntu based distributions like Linux Mint):
    91 {{{
    92 echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
     91{{{#!sh
     92echo "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
    9393}}}
    9494or for Linux Mint:
    95 {{{
    96 echo 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
     95{{{#!sh
     96echo "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
    9797}}}
    9898
    … …  
    100100### below did not work on all systems
    101101and 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 
    111 Now refresh your sources (you may need to install `sudo apt-get install apt-transport-https`)
    112 {{{#!sh
     102{{{#!sh
     103`deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe`
     104}}}
     105}}}
     106
     107Download the [/josm-apt.key public key]:
     108{{{#!sh
     109# Create the directory for manually downloaded keys if it was not already created
     110sudo mkdir -p /usr/local/share/keyrings
     111# Download the key
     112wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg
     113}}}
     114In the past, instructions used `apt-key`. If the key was added to system's keyring, following line will remove it:
     115{{{#!sh
     116sudo apt-key del $(apt-key list | grep -B1  "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57)
     117}}}
     118
     119Now refresh your sources:
     120{{{#!sh
     121# You may need to install ssl support for apt in advance:
     122sudo apt-get install apt-transport-https
     123# Refresh sources
    113124sudo apt-get update
    114125}}}
     126
    115127and install:
    116 
    117128{{{#!sh
    118129# You can skip this first line if these packages were not installed before.
    … …  
    121132# For the tested version
    122133sudo apt-get install josm
    123 # for the development version
     134# For the development version
    124135sudo apt-get install josm-latest
    125136}}}
    … …  
    127138
    128139=== GNU Debian ===#GNUDebian
    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.
     140Our 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`.
     141
     142Since 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.
     143
     144The tested version of [https://packages.debian.org/stable/josm JOSM] is available under **''main''** in section **''utils''**, but the version is usually quite old. \\
     145Please, use the [https://backports.debian.org backports repository] to get a more up-to-date version, see [https://backports.debian.org/Instructions Instructions]. Still this version might be quite old.
    136146
    137147=== openSUSE  ===#Opensuse
    138 [=#openSUSE]
    139 The tested version of JOSM is available in the Application:Geo repository.
    140 
    141 First add as root user in yast or with zypper the repository (replace the version in the URL with the one you are using):
    142 {{{
    143 zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0 Application:Geo
     148The tested version of JOSM is available in the Application:Geo repository.[=#openSUSE]
     149
     150First add as root user in yast or with zypper the repository (for Tumbleweed replace **$releasever** with **openSUSE_Tumbleweed**):
     151{{{#!sh
     152zypper ar -f 'https://download.opensuse.org/repositories/Application:/Geo/$releasever' Application:Geo
    144153}}}
    145154
    … …  
    149158== Troubleshooting ==
    150159=== Java ===#Java
    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 was tested with Oracles variant, so we used to recommend getting Java from their pages for [https://www.java.com/download/manual.jsp manual] downloads or [https://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html intermediate] versions.
    154 
    155 JOSM now recommends [https://www.azul.com/downloads/?package=jre-fx#download-openjdk 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 8 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].
     160When you double-click on a jar file and nothing happens in most cases this means Java isn't installed.
     161
     162JOSM 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].
    156163
    157164
    … …  
    177184=== Web Start ===#Webstart
    178185[=#Troubleshootingjhlplink]
    179 You need to install [https://openwebstart.com/ OpenWebStart] first. It will download and run Java by itself. 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.
     186You 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.
    180187
    181188You 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.
    … …  
    194201
    195202For 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.
    196 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`.
     203If 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`. In Debian/Ubuntu you can edit the file `/etc/default/josm` respectively `/etc/default/josm-latest`. \\
    197204Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages.
    198205