These are legacy instructions for installing RTXI v1.4 from source. Alternatively, you can use our v1.4 live CD, which uses Ubuntu 10.04. Due to its age, many libraries v1.4 uses have become outdated, and they can cause errors and prevent prevent successful installation. These instructions are intended to work for Ubuntu 12.04/14.04 and Debian 7/8. To install RTXI 1.4 from source, follow these steps:

Note: For real-time performance, you will need to have installed a real-time kernel.

1. Clone the GitHub repository.

Install Git if you haven't already. Then, run in the terminal:

$ git clone https://github.com/rtxi/rtxi.git
$ cd rtxi

2. Check out the last v1.4 commit.

Check out the last commit on master that built RTXI v1.4. Run git checkout with the commit hash as follows:

$ git checkout 8178f288310377284c1058ca2d188a1a8ae309fc

3. Run the setup script.

At the base of the RTXI directory, you will see a script called `setup.sh`. Run it:

$ ./setup.sh

The script will run for a little bit, and you will be prompted for a password. Later, you will be asked for your computer configuration (i.e. the RT kernel and DAQ driver). There are four options:

  1. RTAI+Comedi
  2. RTAI+Analogy
  3. Xenomai+Analogy
  4. POSIX (Non-RT)+Analogy

For options 1-3, you need to have a realtime kernel installed. If you installed using the Live CD for v1.4, you already have an RTAI-patched kernel, so choose option1. If you patched and installed a kernel based on our instructions, pick option 3. If you are unsure, enter uname -r in the terminal to see.

Type in the option (be sure to press the right button), and let the script finish running. It will install dependencies and them compile and install RTXI. When it finishes, you'll have RTXI 1.4 installed.

4. Run RTXI.

With RTXI installed, enter rtxi in the terminal.

$ rtxi

Depending on the installation option you chose, you may need to run sudo rtxi.