Other Linux Software Configuration

Laurent Deru edited this page Jun 20, 2017 · 17 revisions

6LBR should work with any Linux distribution or with MacOS-X. If your distribution is not Debian-like, you might have to manually update the start-up scripts or the dependencies.

This page describes the generic Linux installation, see the RaspberryPi or BeagleBone pages for platform specific remarks.


The external package bridge-utils is required for the tap-bridging mode. For example for Debian, you can install it using the following command :

apt-get install bridge-utils

On MacOS-X, bridging is only supported from Lion onwards.

Binary package installation

6LBR can be installed using .deb packages. You can either build the packages yourself, or download the .deb file hosted on the 6LBR project website.


We provides binary packages for Debian based BeagleBone and Raspberry. Check the releases page for the latest packages.

wget https://raw.github.com/wiki/cetic/6lbr/releases/rpi/cetic-6lbr_1.4.0_armhf.deb


dpkg -i cetic-6lbr_1.3.3_armhf.deb 

Installation from sources

If you prefer to follow the latest updates rather then use the packages, you can build 6lbr from the sources. The master branch will always contain the latest tag and is a stable branch. The develop is the unstable work-in-progess, use at your own risk. Periodically, more stable snapshots are created for the develop version.


Git and libncurses are required for fetching and building the sources. For example for Debian, you can install them using the following command :

apt-get install git build-essential libncurses5-dev


  1. Obtain the latest version of 6LBR:
    git clone https://github.com/cetic/6lbr
    cd 6lbr
    git checkout develop-xxxxx #optional, if you plan to use a develop snapshot</pre>
    git submodule update --init --recursive
    cd examples/6lbr


  1. In 6lbr source directory, do the following commands :
    make all
    make plugins
    make tools


  1. Install it directly (as root)
    make install
    make plugins-install
    update-rc.d 6lbr defaults


  1. Chose your run mode, by default 6LBR starts up as Router, but other modes are possible, see 6LBR-Modes
  2. Chose your interface configuration
  3. Update the configuration file as needed using the documentation as reference.
  4. Start the daemon
    service 6lbr start
  5. Check the connectivity, once 6LBR is started you should be able to ping and reach the web server. If you’re not sure of 6LBR address, you can retrieve it in /var/log/6lbr.ip. If this file is not present or empty, that means 6LBR could not start properly
  6. Configure the Runtime Parameters, e.g. your network prefix, NAT64, … in the webserver Configuration Page
  7. Configure your whole network and enjoy :)
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.