JMRI® is...
JMRI Setup and Installation
JMRI environments...
By the community of
JMRI tools for working with your layout:
Layout Automation
Use JMRI to automate parts of your layout and operations:
Supported Hardware
Devices, command stations, networks, and protocols:

JMRI Help:

Contents Index
Glossary FAQ

Donate to

JMRI®: Setup

General Installation


Full instructions for installing JMRI on different platforms can be found here:

JMRI® requires that Java be installed:

As of JMRI 4.20, JMRI is only fully supported when running on Java release 8 or 11. As of JMRI 4.99.1, JMRI is only fully supported when running on Java release 11 as noted above. Some problems have been encountered while using a Java version beyond Java 11 and support is offered only on a "best effort" basis. Some issues may only be addressable by using a supported version.

Starting the program

Once you have downloaded the JMRI® software and installed it, simply open the program in the usual manner for your operating system. Windows will show an icon on desktop (with default install options selected).

windows desktop icons

Double click the icon for the program to open.

If the DecoderPro® icon was selected, the DecoderPro® Roster will be displayed.

If PanelPro was selected, a startup dialog will be displayed.

Start dialog

The startup dialog has two options which can be used to defer processing of the Logix and LogixNG tools. These tools are used automate JMRI processes but they can also interfere with normal processing which can require debugging.

If this is the first time you run the program after you installed the software, the Preferences screen will come up automatically to allow you to set up the system for your particular configuration. Also if you change your system configuration, OR if you have your laptop away from the railroad, but you want to play with JMRI there is a simulator mode you may want to try.
[To be continued]

Setting your Preferences

Fixing Problems