Windows:

If you have not already done so, download the latest stable version of openBVE and extract it to a folder of your choice. This folder will be called your openBVE folder from here on.

First try launching the program, by double-clicking on the main openbve.exe in the top-level openBVE folder. In many cases, Windows Update will have already installed the .Net framework for you, and you will need to do nothing.

If however, this is not the case please download the .Net framework Web Installer from Microsoft:

http://go.microsoft.com/fwlink/?LinkId=181011

Follow the instructions in this installer, and then try launching the program again.

Linux:

Some Linux distributions provide openBVE as a ready-to-install package.

In some cases, this version may be behind the most recent stable version.

Ubuntu and Debian:

openBVE is part of the main package repositories, and may be installed using the following apt-get command:

Arch Linux

openBVE is part of the ‘City’ unofficial repository.

Other Distributions:

If you have not already done so, download the latest stable version of openBVE and extract it to a folder of your choice. This folder will be called your openBVE folder from here on.

You will then need to install the latest version of the Mono framework, using the packages provided by the Mono Project:

http://www.mono-project.com

Alternatively, Mono will usually be available via your distribution’s package manager.

Launching the Program:

openBVE may be launched from a terminal using the command

in the root openBVE folder. If you installed openBVE using a distribution’s packaged version, then an icon will hopefully have been added to your Games menu.

Mac OS-X:

If you have not already done so, download the latest stable version of openBVE.

Mount the .dmg file, and drag openBVE to your applications folder.

Please note that openBVE is an unsigned application, and depending on your security settings may require you to add an exception to OS-X’s gatekeeper, as described in this Apple Support document:

https://support.apple.com/kb/PH18657?locale=en_US

Double-click on the openBVE application, and it will automatically prompt you to download and install the Mono framework if required.