Building GNU Radio

To build and install GNU Radio, you may either download a release tarball, or you may use the Subversion client software to check out code from our Subversion repository. Some operating systems may have binary installation packages available; see Operating System Specific Instructions below.

To checkout the latest stable release code, enter this on the command line:

$ svn co http://gnuradio.org/svn/gnuradio/branches/releases/3.1 gnuradio

To instead checkout the latest code from the development trunk, enter this on the command line:

$ svn co http://gnuradio.org/svn/gnuradio/trunk gnuradio

In general, if you are developing GNU Radio applications which need to depend on the stability of the features and API of GNU Radio components, it is recommended that you use the 3.1 stable release series.

This page assumes that you are building from code checked out from our subversion repository. If you're building from a release tarball, do not perform the ./bootstrap step.

First, ensure that you've fulfilled the dependencies specified in the top-level README. Most GNU/Linux systems come with our dependencies already packaged. You may need to install them off of your install CD/DVD or over the net. See below for Operating System specific notes.

To compile, there are 5 steps. Start by cd'ing to the gnuradio directory, then complete the following commands:

$ ./bootstrap         # Do NOT perform this step if you are building from a tarball.
$ ./configure
$ make
$ make check
$ sudo make install

This will perform all configuration checks and select for build, test, and installation all components that pass.

For finer control, read the instructions at BuildConfiguration.

Operating System Specific Instructions

This section links to guides which go into more specific detail for a given operating system, outlining how to fulfill the build prerequisites, any non-standard build steps that must be taken, and general configuration issues. If a given operating system has binary installation packages or another automated way to build GNU Radio, it will be listed here.

• Linux
  • Arch
  • Debian
  • Fedora
  • Gentoo
  • Mandriva
  • SuSE
  • Ubuntu
• Mac OS X
• NetBSD (likely also appropriate for DragonflyBSD and helpful for OpenBSD and FreeBSD)
• Windows

Installation on the Play Station 3

• Linux
  • Fedora 7
  • Fedora 8 (recommended)

USRP FPGA Firmware

To compile the verilog source code for the fpga firmware for the usrp you need Altera Quartus II Web Edition. This is only needed if you change the verilog code, since the distribution contains precompiled versions of this firmware.

How to run Quartus II under Linux

Current Known Build Problems

#130

swig dependencies are calculated in a fragile way

#135

lib64 configure test is enabled on other than systems known to use this convention

#184

problem w/ cvsd-vocoder on t162 (64-bit problem?)

#191

make check fails in usrp/host/lib/inband on Cygwin

#254

using pkg-config's <foo>_CFLAGS is wrong when you want the CPPFLAGS.