Link Search Menu Expand Document
Tramola

Installation

The installation process of Tramola was designed to be simple and quick. Download, unzip and start it, and after a few clicks you are ready to use Tramola.

Requirements

  • Java 17 or newer
  • Tramola License Key

Download and Extract

  • Download Tramola.
  • Extract the downloaded zip-file.
  • Place the extracted tramola directory in the place you deem appropriate.

First Start

  • Open a command line interface (e.g. Command Prompt or PowerShell on Windows, Terminal.app on macOS, some shell on Linux).
  • Switch to the directory where you placed Tramola (e.g. cd /path/to/tramola/)
  • Start Tramola with Java 17 or newer: java -Xmx3g -jar tramola.jar.
  • After a few seconds, you should see a message that states “Tramola is ready.” along with a URL (http://localhost:3471/ by default).
  • Open that URL in a browser.
  • You should be greeted by a welcome screen.
  • Enter a username and password for the first administrator account, then click on Next.
  • Enter the license key, then click on Next.
  • Select the MATSim version you want to use by default, and click Next.

Tramola will now set up the initial user and download the specified MATSim version. Once everything is ready, you can click Next a final time and you will be taken to the regular Tramola user interface.

Backup Configuration

During the first start, Tramola will create two random passwords it uses to protect your data. These passwords are automatically saved in the file conf/tramola.conf. Please store a copy of the conf-directory in a safe place, as without these passwords, Tramola will not be able to access all the data it manages.

Make sure to back up the conf directory.
Otherwise your data might become unreadable if you need to restore your setup.

For savety reasons, make sure the file conf/tramola.conf is only readable by the user running the Tramola process.

System Requirements

Java 17
Tramola requires at least Java 17 to run. We suggest using a Temurin OpenJDK from the Adoptium project.
6 GB RAM
For typical, small-sized installations, 6 GB should be sufficient to run Tramola. 3 GB are used for Tramola itself (i.e. specifying -Xmx3g when starting Tramola), while the other 3 GB may be used by additional processes managed by Tramola. More memory might be necessary for large instances.
Additional memory will be used to simulate the actual scenarios and may depend on the size and complexity of the scenario.
Non-Headless environment
Although Tramola runs on a server, parts of it require a window system. This isn’t an issue on macOS or Windows, where such a system is always available, but might be an issue on Linux server installations. Detailed instructions for Linux are available separately.