More instructions on how to install from open build service are
here for the main project
and here for the playground.
Ubuntu, Debian and Arch users please see the community repositories above.
macOS
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 three of the most recent
major macOS versions (currently Big Sur, Monterey and Ventura) 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.
Download SUMO launchers0.8 MB
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.
Sources
Download the sources, examples, and CMake-files for creating Visual Studio
solutions or Linux Makefiles. This download does not contain tests. Download as:
sumo-src-1.18.0.tar.gz72.5 MB
sumo-src-1.18.0.zip76.4 MB
Python packages / Virtual environments
Starting with SUMO 1.8.0 (for macOS since 1.12.0) the installation is also possible from the Python packaging index.
You can install either the applications: pip install eclipse-sumo or only traci (pip install traci), libsumo (pip install libsumo) or sumolib (pip install sumolib).
This should work for Windows, macOS and all Linux versions which are more recent than 2014.
The applications are available for Python 2 and Python 3, libsumo only for Python 3.6 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
macOS dependencies
In order to use the Python wheels on macOS you need to have all the dependencies installed and up to date via brew for instance by following the standard installation once.
To take full advantage of all Python tools
please install the dependencies via pip install -r $SUMO_HOME/tools/requirements.txt.
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 (you may need to sign in to GitHub).
Nightly Snapshots
v1_18_0+2081-5021ae65443
The code within the repository is compiled each
night. All Windows builds are for the 64bit platform. For an explanation of the contents and the
licensing (especially concerning the "extra" build which contains GPL code to support GeoTIFFs, shapefiles and 3D models),
see the notes below. The following packages can be obtained:
Sources: https://sumo.dlr.de/daily/sumo-src-git.tar.gzOctober 13 2023 22:10:22 UTC72.5 MB
Sources: https://sumo.dlr.de/daily/sumo-src-git.zipOctober 13 2023 22:10:17 UTC76.4 MB
Sources and static HTML documentation: https://sumo.dlr.de/daily/sumo_git.orig.tar.gzOctober 13 2023 22:10:28 UTC76.6 MB
Windows installer: https://sumo.dlr.de/daily/sumo-win64-git.msiOctober 13 2023 23:16:26 UTC136.4 MB
Windows zip: https://sumo.dlr.de/daily/sumo-win64-git.zipOctober 13 2023 23:14:52 UTC117 MB
Windows installer with all extras (contains GPL code): https://sumo.dlr.de/daily/sumo-win64extra-git.msiOctober 14 2023 03:18:52 UTC169.1 MB
Windows zip with all extras (contains GPL code): https://sumo.dlr.de/daily/sumo-win64extra-git.zipOctober 14 2023 03:17:05 UTC149.5 MB
Windows 64-bit binaries of the SUMO game: https://sumo.dlr.de/daily/sumo-game-win64-git.zipOctober 13 2023 23:17:31 UTC69.4 MB
Windows 64-bit debug version: https://sumo.dlr.de/daily/sumo-win64Debug-git.zipOctober 13 2023 23:26:11 UTC291.9 MB
The nightly builds are also available from the Python packaging index test instance.
To install the latest nightly version (it is strongly encouraged to do this in a virtual environment) use the instructions above replacing the install line with:
pip install -i https://test.pypi.org/simple/ eclipse-sumo
Although this is a python package, it contains all compiled SUMO binaries and should be fully functional (see the requirements in the section above). Due to space limitiations of test.pypi.org, this is going to be replaced by
a self-hosted solution. You may already try out:
pip install -f https://sumo.dlr.de/daily/wheels/ eclipse-sumo
The nightly python wheels are also available for libsumo, sumolib and traci.
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.
Caution
The available Windows binary packages may lag behind the latest Git revision due to being compiled only once per day (around midnight, Berlin time).
Older releases and alternative download
The release directory contains all release files since 1.2.0.
Those and older releases can also be obtained via the sourceforge download portal.
If you want to try out an older version you can also use the virtual environment approach
(explained above) with a fixed version, e.g.
pip install eclipse-sumo==1.9.0 (works only for 1.8.0 and later).
If you need a complete zipped snapshot of the repository (including tests) for an older version have a look at the tags in your
local repository or at GitHub tags.
Other
Direct repository access
You can get the 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.
Packages
SUMO is available as different packages. The contents of each package is
listed in the table below.
Dependencies for developers
For the Windows platform you can retrieve all dependencies by cloning
this repository: https://github.com/DLR-TS/SUMOLibraries, 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
complete scenarios
networks
traffic data
Test cases
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 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.
