1. Introduction
This document describes how to build the LinuxCNC software and documentation from source. This is primarily useful if you are a developer who is modifying LinuxCNC. It can also be useful if you’re a user who is testing developer branches, though then you also have the option of just installing Debian packages from the buildbot: http://buildbot.linuxcnc.org
1.1. Quick Start
For the impatient, try this:
> git clone git://github.com/linuxcnc/linuxcnc.git linuxcnc-dev > cd linuxcnc-dev/src > ./autogen.sh > ./configure --with-realtime=uspace > make
That will probably fail! That doesn’t make you a bad person, it just means you should read this whole document to find out how to fix your problems. Especially the section on Satisfying Build Dependencies.
If you are running on a realtime-capable system (such as an install from the LinuxCNC Live/Install Image, see the Realtime section below), one extra build step is needed at this time:
> sudo make setuid
After you’ve successfully built LinuxCNC it’s time to run the tests:
> source ../scripts/rip-environment > runtests