[[TranslatedPages]]
= Download =

== Overview ==

|| ||= OS Independent =||= [http://www.java.com/en/download/faq/java_webstart.xml Web Start] =||= Windows =||= Mac OS X =||= Ubuntu, … =||
||= **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] || ''[#Ubuntu see below]'' ||
||= latest [[Version(latest)]] =|| [/josm-latest.jar jar] || [/download/josm-latest.jnlp jnlp] || || || ''[#Ubuntu see below]'' ||
||= older =|| [/download/ download/] || || || || ||

 * **Which version should I use?** (see also: [wiki:Releases release system])
   * ''tested'' is released approx. monthly and shouldn't contain severe bugs
   * ''latest'' is released daily, may have more errors
   * If possible, use the Web Start version in order to automatically update.

----

 * **Note that there are fairly regular updates, so always try running a recent version (and also recent plugins).**
 * Access [/download/josm.jnlp JOSM-WebStart] without installation
 * Download the **[/josm-tested.jar tested JOSM ]** version [[Version(tested)]]
 * Download the [/download/windows/josm-setup.exe Windows JOSM installer] version [[Version(windows)]]
 * Download the [/download/macosx/josm-macosx.zip Mac OS X JOSM package] version [[Version(macos)]]
 * Prepare a [wiki:USB_Stick USB flash drive] to use JOSM on any foreign Windows machine.
 * For download scripts use version check for [/latest latest] and [/tested tested] (or [/version both]) to reduce download bandwith
 * If download size is an issue for you, you may append `?lang=..` to the download link for both releases to strip all unused translations (e.g. `?lang=de` would download JOSM in German language only).

== Development Version ==

 * Download the **[/josm-latest.jar latest JOSM]** version [[Version(latest)]] (may have more errors than "tested", be careful with this one).

== Applet ==

 * Try **[/applet JOSM applet]** after reading the [wiki:Applet applet description].

== Source ==

 * Get the source:
   * From the official Subversion repository (recommended): {{{svn co http://josm.openstreetmap.de/svn/trunk}}}
   * From the unofficial [http://github.com/openstreetmap/josm GitHub mirror]: {{{git clone git://github.com/openstreetmap/josm.git}}}
   * From the official OSM Subversion repository (including plugins): {{{svn co http://svn.openstreetmap.org/applications/editors/josm josm}}}

== Ubuntu repository ==#Ubuntu

The repository for Ubuntu contains two packages:
 {{{josm}}}:: ''The tested version''[[br]]
  Replaces the package from the official Ubuntu repository.
 {{{josm-latest}}}:: ''The development version (nightly build)''[[br]]
 Can be installed parallel to the {{{josm}}} package. The default preference folder is {{{~/.josm-latest}}}.
=== Installation ===
Depending on your Ubuntu-Version, add one of the following lines to your {{{/etc/apt/sources.list}}}:
{{{
deb http://josm.openstreetmap.de/apt lucid universe
deb http://josm.openstreetmap.de/apt natty universe
deb http://josm.openstreetmap.de/apt oneiric universe
deb http://josm.openstreetmap.de/apt precise universe
}}}
 **Note**: You can just run "{{{lsb_release -c}}}" in a terminal to get the proper codename.
Download and register the public key:
{{{
wget -q http://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -
}}}

Now refresh your sources
{{{
sudo apt-get update
}}}
and install:
 {{{josm}}}:: (You can skip the first line if you haven't installed these packages before.)
{{{
sudo apt-get remove josm josm-plugins
sudo apt-get install josm
}}}

 {{{josm-latest}}}::
{{{
sudo apt-get install josm-latest
}}}

=== useful options ===

If JOSM runs out of memory, you can increase the maximum size of allocated memory (in megabytes - max ±1.5GB for 32bit java, system dependent):
{{{
JAVA_OPTS="-Xmx400M" josm
}}}

Start with a different preference folder:
{{{
JAVA_OPTS="-Djosm.home=$HOME/.josm-tmp" josm
}}}