User Tools

Site Tools


Rocrail ZIP


'Rocrail ZIP' is provided as ZIP archive, and can be downloaded from the Daily Build site.

Rocrail ZIP allows to "install"1) to (almost) any location on the computer: For example, on the desktop, on a second internal drive, etc. All files needed by Rocrail are stored in one folder; there are no files created or hidden outside this folder (except the optional desktop icon).

If enough memory2) is available, the ZIP file can even be unzipped to a memory stick.
This allows portable usage on changing hardware, but with the same operating system.

Important Notes:

  1. Backup your workspaces.
  2. Deinstall a previous Rocrail installation if the Setup.exe was used.
  3. In order for an update not to overwrite files modified for own purposes (Images, SVG, Decspecs etc.), these must be saved with changed file names or in a separate directory
  4. The User- and AmericanThemes, if needed must be unzipped separately, usually in the "svg" folder.

Instruction Videos

Unzipping and Starting


Help for switching from a classic installation to the installation with a ZIP file: Switching to ZIP installer explained step by step.

Simply unpack the ZIP archive into a directory of choice and double-click on the script file desktoplink.cmd 3) to create a shortcut of Rocview on the desktop. A workspace can be selected to start the server.

When starting for the first time a safety warning from Windows Defender may be displayed (screenshot). First, the text More info has to be clicked, then in the modified dialogue (screenshot) button Run anyway has to be clicked.

Detailed installation instructions can be found under Install Rocrail under Windows


For an initial Rocrail installation, the dependency wxWidgets need to be installed. These commands are included in
Just unzip it in the home directory (not copied to the system) and double click on the to create a Rocview Desktop shortcut with all needed parameters to startup a workspace..


If the file explorer opens the script files in an editor, its easier to open a terminal, and change the directory into the place where the ZIP file is located. Then issue following commands: (The same sequence can also be used for updating.)

unzip -u -d Rocrail Downloads/Rocrail*.zip
cd Rocrail

If the wxWidgets library is not yet installed:


Gnome Desktop

An extension is needed if the Rocview Desktop Icon does not appear.
Open a terminal window and type in the following commands:

sudo apt install gnome-tweaks
sudo apt install gnome-shell-extension-desktop-icons

After Gnome Tweaks did open, select in the left column "Extensions", and activate "Desktop icons".
The Rocview Desktop Icon will at first look like a text document. Activate in the context menu, right click on this icon, and activate "Allow Launching".

Raspberry Pi


Important Note:
In order for an update not to overwrite files modified for own purposes (Images, SVG, Decspecs etc.), these must be saved with changed file names or in a separate directory.

  1. Download a current ZIP-Archive.
  2. Extract the new zip file into the Rocrail folder
  3. Extract all files.
  4. Confirm the following question "Replace the files in the destination":

Advanced Update Option

Not for novice users!
  1. Download a current ZIP-Archive.
  2. Extract only the BIN folder into the Rocrail folder.
    This only updates Rocview, Rocrail server and libraries.
  3. Confirm the following question "Replace the files in the destination":
  • Important note:
    As files in other directories (svg, decpecs, …) are also updated and expanded irregularly, it is strongly recommended to carry out complete updates more often.

Demo and Wiki Plans

Demo-Plan Wiki-Demo-Plan
"Step by Step"

To access the Demo plan select File→Demo Workspace.
To access the Wiki Demo plan select File→Open Workspace (in this directory look for the wikidemo folder and select.)

  • Note: If a workspace is active, then the termination of the server must be confirmed.

Directory structure

├───desktoplink.cmd     (Windows -- Icon on the desktop)
├───rocview.cmd         (Windows -- Rocview and Server)
├───readme.txt          (Information)
├───start.html          (Startup Help with links to the stepbystep-xx Wiki pages)
├─── (Revision number and the last 500+ revisions)
├───      (Linux   -- Icon on the desktop)
├───        (Linux   -- Install wxWidget)
├───rocrail.png         (Linux   -- Rocrail icon)
├───          (Linux   -- Rocview and Server)
├───          (Linux   -- Server only)
├───     (Linux   -- Script for use with crontab; Copy or symlink it into ~)
├───      (Linux   -- Init default workspace with symlinks to: svg, web, images, decspec)
├───           (Linux   -- Update Rocrail by Server Monitor)
├───        (Linux   -- Update OS by Server Monitor)
├───default             (Default empty workspace in case of crontab and/or Server Monitor)
|   └───plan.xml        (wiki demo plan)
├───demo                (default demo workspace)
|   └───plan.xml        (larger plan with shadow station)
├───web                 (Rocweb data)
├───bin                 (Executables and libraries)
├───decspecs            (Rocpro decoder specification)
├───stylesheets         (Docu formats)
├───images              (Pictures: Symbols, Locs, Wagon, ...)
└───svg                 (Scalable Vector Graphics)
  • Note: The individual "Rocrail Zip" ZIP archives contain only the parts of the Directory structure above
    that are relevant for the respective Operating system.
Rocrail ZIP is not actually installed, but only unzipped
For WIN64 with the ZIP files and all themes about 120 MByte
depending on your windows installation the .cmd might not show. See: FAQ
rocrailonastick-en.txt · Last modified: 2022/02/22 19:01 by rjversluis