GNU Radio+UHD Software Installation (Linux)

We provide UHD and GNU Radio binary installers for Ubuntu and Fedora users. There are two choices:
  • Unstable: Built off of GNU Radio's master branch and an unstable UHD install, which includes bugfixes and new features.
  • Stable: Built off of GNU Radio's maint branch and a stable UHD install, which only includes bugfixes since the last major release.

These GNU Radio installers will only work with their corresponding UHD binary. If you use an unstable UHD binary with a stable GNU Radio binary (or vice versa), you will not be able to use any gr-uhd features.

We only support versions of Ubuntu and Fedora that are officially maintained and supported. Currently supported platforms are:

  • Ubuntu 12.04, 12.10, 13.10
  • Fedora 19-20

NOTE: Our GNU Radio binaries depend on our UHD binaries, so all instructions involve installation of both.

Install with Apt/Yum

Our UHD and GNU Radio binaries can be installed using our Ubuntu and Fedora repositories. Follow these instructions to install UHD and receive package updates.

Ubuntu

NOTE: Only follow one set of these instructions at a time. Our unstable and stable repositories will conflict.

  • Master/Unstable
    • Copy and paste these commands into your terminal. This will install GNU Radio+UHD as well as allow you to receive package updates.
      sudo bash -c 'echo "deb http://files.ettus.com/binaries/uhd_unstable/repo/uhd/ubuntu/`lsb_release -cs` `lsb_release -cs` main" > /etc/apt/sources.list.d/ettus.list'
      sudo bash -c 'echo "deb http://files.ettus.com/binaries/uhd_unstable/repo/gnuradio/ubuntu/`lsb_release -cs` `lsb_release -cs` main" >> /etc/apt/sources.list.d/ettus.list'
      sudo apt-get update
      sudo apt-get install -t `lsb_release -cs` uhd gnuradio
      
  • Releases/Bugfixes
    • Copy and paste these commands into your terminal. This will install GNU Radio+UHD as well as allow you to receive package updates.
      sudo bash -c 'echo "deb http://files.ettus.com/binaries/uhd_stable/repo/uhd/ubuntu/`lsb_release -cs` `lsb_release -cs` main" > /etc/apt/sources.list.d/ettus.list'
      sudo bash -c 'echo "deb http://files.ettus.com/binaries/uhd_stable/repo/gnuradio/ubuntu/`lsb_release -cs` `lsb_release -cs` main" >> /etc/apt/sources.list.d/ettus.list'
      sudo apt-get update
      sudo apt-get install -t `lsb_release -cs` uhd gnuradio
      

Fedora

NOTE: Only follow one set of these instructions at a time. Our unstable and stable repositories will conflict. If you are switching between our unstable and stable repositories, run the following command before doing so:

sudo yum clean metadata all
  • Master/Unstable
    • Follow these instructions to install GNU Radio+UHD and receive package updates.
    • Create the file "/etc/yum.repos.d/ettus.repo". Copy this into the file:
      [ettus-uhd-master-repo]
      name=Ettus Research - UHD Unstable $releasever-$basearch
      baseurl=http://files.ettus.com/binaries/uhd_unstable/repo/uhd/fedora/$releasever/$basearch
      gpgcheck=0
      
      [ettus-gnuradio-master-repo]
      name=Ettus Research - GNU Radio Unstable $releasever-$basearch
      baseurl=http://files.ettus.com/binaries/uhd_unstable/repo/gnuradio/fedora/$releasever/$basearch
      gpgcheck=0
      

      Run the following command:
      sudo yum install --enablerepo='ettus-uhd-master-repo' --enablerepo='ettus-gnuradio-master-repo' --disablerepo=updates uhd gnuradio
      
  • Releases/Bugfixes
    • Follow these instructions to install GNU Radio+UHD and receive package updates.
    • Create the file "/etc/yum.repos.d/ettus.repo". Copy this into the file:
      [ettus-uhd-stable-repo]
      name=Ettus Research - UHD Stable $releasever-$basearch
      baseurl=http://files.ettus.com/binaries/uhd_stable/repo/uhd/fedora/$releasever/$basearch
      gpgcheck=0
      
      [ettus-gnuradio-stable-repo]
      name=Ettus Research - GNU Radio Stable $releasever-$basearch
      baseurl=http://files.ettus.com/binaries/uhd_stable/repo/gnuradio/fedora/$releasever/$basearch
      gpgcheck=0
      

      Run the following commands:
      sudo yum --enablerepo='ettus-uhd-stable-repo' --enablerepo='ettus-gnuradio-stable-repo' --disablerepo=updates install uhd gnuradio
      

Installer Packages

We provide standalone binaries for all supported platforms. These binaries are generated every weekend.

NOTE: Installing packages with this method will not install all necessary dependencies. Run the following command to install runtime dependencies:

Ubuntu

sudo apt-get install python python-wxgtk2.8 pyqt4-dev-tools python-qwt5-qt4 python-numpy libboost-all-dev libusb-1.0.0-dev

Fedora

sudo yum install python wxPython-devel PyQt PyQwt numpy boost-devel libusb-devel

Before installing a GNU Radio binary, a compatible UHD binary must be installed. GNU Radio unstable binaries are only compatible with UHD unstable binaries, and GNU Radio stable binaries are only compatible with UHD stable binaries.

Follow these instructions to install a stand-alone UHD binary: UHD Linux.

Once that is done, install a corresponding GNU Radio binary.