SUMO - Latest Release (Version 1.10.0)#

Release date: 17.08.2021

MS Windows binaries#

Contains the binaries (32 or 64 bit), all dlls needed, the examples, tools, and documentation in HTML format. For an explanation of the contents and the licensing, especially concerning the "extra" build, see the notes below



Includes sources, examples, and CMake-files for creating Visual Studio solutions or Linux Makefiles. Does not contain tests. Download as:


Includes sources, tests and docs but no binaries. Download as:

Linux binaries#

The community maintains several repositories notably at the open build service. For a detailed list of repositories see below.

Furthermore there are a debian and an ubuntu launchpad project as well as an archlinux package:

To add the most recent sumo to your ubuntu you will need to do:

sudo add-apt-repository ppa:sumo/stable
sudo apt-get update
sudo apt-get install sumo sumo-tools sumo-doc


If the repositories do not contain the libraries (like proj and gdal) they are either part of the distribution or you will need them from another repository (you may try one of the build service repositories here too, e.g. Application:Geo). At the moment there is no documentation included in the packages. The repositories include a nightly build as well (called sumo_nightly).

Ubuntu, Debian and Arch users please see the community repositories above.


You can read the Homebrew-based installation guide here or follow the Build instructions here.

"Bottles" are available for installing with Homebrew. They are built for the two most recent major macOS versions (currently Mojave and Catalina) and are built from source with minimal requirements (fox, proj, xerces-c). If you need optional libraries, you can specify these on the brew command line and brew will compile SUMO from source. For details, see the Formula's README.

Application launchers#

In order to have a more native feel on macOS, we provide some application launchers (icons / shortcuts). These launchers work with all versions of SUMO and do not need to be updated.

These launchers allow you to select sumo-gui as the default application to open .sumocfg files on macOS, and even add sumo-gui, netedit and the OSM Web Wizard to the dock.

Important notice

In order to use the launchers, make sure you have installed SUMO beforehand (any version) and have set the SUMO_HOME environment variable.

Python packages / Virtual environments#

Starting with SUMO 1.8.0 the installation is also possible from the Python packaging index. You can install either the applications: pip install eclipse-sumo or only traci, libsumo or sumolib, e.g. pip install libsumo. This should work for Windows and all Linux versions which are more recent than 2014 but currently not for macOS. The applications are available for Python 2 and Python 3, libsumo only for Python 3.5 and above. This gives an easy way to test a new SUMO version via virtual environments or a nightly build using the following commands (on Linux):

python -m venv sumo_test
cd sumo_test
. bin/activate
pip install eclipse-sumo

SUMO - Alternative download and older releases#

All releases can also be obtained via the sourceforge download portal.

SUMO - Latest Development Version#

SUMO is under active development. You can find a continuously updated list of bug-fixes and enhancements at our ChangeLog. To make use of the latest features (and to give us pre-release feedback) we encourage you to use the latest version from our code repository.

Every push to our main branch also triggers a build for Windows, Linux and macOS. The results can be found by clicking on the relevant commit here and downloading the appropriate file for your platform.

Nightly Snapshots#


The code within the repository is compiled each night. The following resulting packages can be obtained:

The nightly builds are also available from the Python packaging index test instance. To install the latest nightly version use pip install -i eclipse-sumo. Although this is a python package it contains all compiled SUMO binaries and should be fully functional for Windows and recent Linux.

The Linux repositories at the open build service contain a nightly build as well. This is unfortunately not the case for the Debian, Ubuntu and Arch versions.

The corresponding documentation is also visible live including Doxygen docs. Additional artifacts such as tests results and code coverage analysis are generated every night.


The available windows binary packages may lag behind the latest Git revision due to being compiled only once per day (around midnight, Berlin time).

Direct repository access#

You can get very latest sources directly from our Git repository, see the FAQ on repository access. Normally, they should compile and complete our test suite successfully. To assess the current state of the build, you may take a look at the nightly test statistics.


SUMO is available as different packages. The contents of each package is listed in the table below.

bin build src (source code) user docs developer docs (doxygen) data examples tutorials tests tools (except jars) jars
rpm (✔)

Dependencies for developers#

For the Windows platform you can retrieve all dependencies by cloning this repository, if you want to develop with Visual Studio. If you just want to run SUMO, use the binary downloads above which already contain the runtime dependencies.

Scenarios and other Data#

Note on Licensing#

SUMO is licensed under the EPL-2.0 with GPL v2 or later as a secondary license option using only open source libraries.

The standard Windows build only contains code and Windows binaries with Eclipse approved licenses (especially no GPL and LGPL code). If you need features like shapefile import, GeoTIFF processing, the OpenSceneGraph 3D GUI, or video generation, download the "extra" build.

The Linux packages do not contain external libraries at all.