Installing

From Sumo
Jump to: navigation, search

Windows

There are four different binary packages for Windows depending on the platform (32 vs. 64 bit) you have and what you want to do with SUMO. If you want to install it locally and have administrator rights on your machine you should download and execute one of the installers (preferably 64 bit). If you need a "portable" version or do not have admin rights, use the correct zip, extract it into a desired folder using 7Zip, Winzip, or a similar tool. Every package contains the binaries, all dlls needed, the examples, tools, and documentation in HTML format.

Download 64 bit installer: sumo-win64-0.29.0.msi
Download 64 bit zip: sumo-win64-0.29.0.zip
Download 32 bit installer: sumo-win32-0.29.0.msi
Download 32 bit zip: sumo-win32-0.29.0.zip

Within the installation folder, you will find a folder named "bin". Here, you can find the executables (programs). You may double click on SUMO-GUI and take a look at the examples located in data/examples. All other applications (DUAROUTER, DFROUTER, etc.) have to be run from the command line. To facilitate this there is also a start-commandline.bat which sets up the whole environment for you. If you feel unsure about the command line, please read Basics/Basic_Computer_Skills#Running_Programs_from_the_Command_Line.

If you want a bleeding edge nightly build or need tests or source files, you can download them from the Download page.

For building SUMO from source see building SUMO under Windows.

Linux

If you run debian or ubuntu, SUMO is part of the regular distribution and can be installed like this:

sudo apt-get install sumo sumo-tools sumo-doc

If you need a more up-to-date ubuntu version, it may be found in a separate ppa, which is added like this:

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

and then again

sudo apt-get install sumo sumo-tools sumo-doc

Precompiled binaries for different distributions like openSUSE and Fedora can be found at these repositories for binary Linux versions. These repositories contain nightly builds as well. In the case your system is not listed here or you need to modify the sources, you have to build SUMO from sources.

MacOS

Caution:
MacOS installation via macports is broken since sumo version 0.29.0 due to an external problem with the GUI library provided by macports. We recommend to install SUMO following the homebrew installation guide.

SUMO can be found in the Macports repositories. After installing Macports (this also needs XCode and its command line tools as well as an Apple Developer ID) make sure that an X server was installed (XQuartz worked here) and that you have a terminal application like iTerm2 ready. Now start a terminal session and run

sudo port install sumo

If you need a more recent SUMO version or want to modify the sources you should do the above Macports installation as well to have all the dependencies ready. Afterwards you can follow the instructions of the Linux build with some additions for MacOS.

An alternative way to build SUMO from source is discussed here.