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

Donate to JMRI Donate to

JMRI®: Setup

General Installation


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

JMRI® requires that Java be installed:

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. In this case we will open DecoderPro®

This dialog will appear briefly as the program is loading:

Start dialog

You should see this or a similar opening screen displayed after the program starts:

Splash screen

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