Open source whitebox router

We provide baseboxd, a transparent SDN control daemon that offloads Linux kernel forwarding and routing to hardware switches. baseboxd is open source. It closes the gap between well-established Linux open source routing projects, such as FRR, and whitebox switches.

Basebox is available via 

An Onie image is available via our Download form.

It’s SDN without the difficult part. No need to program any interfaces, just configure the entire router like a Linux box.

Let hardware acceleration do the rest – it centuplicates the router performance.

You only buy the hardware and download the rest. If you like, we will support you – just get in touch to learn about our support schemes!

Our open source router comes in an off-switch and an on-switch flavor. In addition, we offer Basebox Fabric, a commercial turnkey solution with switches and software in high availability configuration.


Basebox on-switch

The on-switch version is lean, since it

  • feels like a “real” router
  • works out of the box
  • requires no initial configuration
  • is easy to maintain and
  • inexpensive, since it requires no additional devices

Basebox on-switch

Basebox off-switch

The off-switch version provides a native SDN solution with

  • less kernel dependencies
  • more space and
  • infinite compute power
  • it opens new options, such as route compression or telemetry

Basebox off-switch

Basebox Fabric

In addition to the Open Source components baseboxd and BISDN Linux we deploy a shim controller that speaks OpenFlow (OF-DPA 3.05) northbound as well as southbound. Doing so, it presents a single switch abstraction to the upper SDN controller baseboxd, and acts as a controller to the lower switches.

The CAWR controller creates virtual interfaces from the Multi-Chassis Link Aggregation (MLAG) that the (typically two) ToR switches create. This way, multiple network interfaces are used from the servers, further increasing the available throughput.

Networks can either be isolated using VLANs or VXLAN, the latter typically requiring a L3 configuration of the switches. The baseboxd controller is able to locally create VXLAN endpoints on the switches as well, catering for data-center interconnects.



BISDN Linux version 3.6

Basebox consists of baseboxd, an SDN controller, and BISDN Linux, a switch operating system.



  • L2 Learning switch
  • L3 Routing (IPv4 and IPv6)
    • BGP
    • OSPF
    • EIGRP
    • RIP
  • Virtual routing and forwarding (VRF)
  • Spanning Tree Protocol (STP)
  • Link aggregation (LAG) supported for modes ‘balance-rr’, ‘active-backup’ and ‘802.3ad’
  • 802.1q and 802.1ad bridging
  • IGMP/MLD Snooping
  • Switch statistics available via OpenFlow
  • gRPC interface to export switch statistics based on openconfig-interfaces
  • Support source-MAC learning
  • Support group modifications from OF-DPA3.0
  • Tested on yocto 2.7 (warrior) (on-switch)


based on yocto 2.7 (warrior)


  • Choice of SDN controller (on switch or off switch) configurable 
  • On-switch routing daemon (FRR) to run with baseboxd
  • OF-DPA grpc endpoint and local command-line interface
  • Supports port and SFP inspection via onlpdump and client shell
  • OF-DPA 3.05 (including group modifications)
  • Port mirroring (ingress/egress)


Supported platforms and release notes:




Join the Basebox Community on Slack 

This page explains how to join and how to use the Basebox community on Slack. If you would like to join the Basebox Slack community, please self-register via the invitation link or request an invitation via

If you require commercial support and have purchased a commercial support plan, please use our Support platform.

First steps with Slack

The Basebox community is a group of developers that are using the open source operating system for whitebox switches. 

Once you have received your invitation and finished the signup process, you can use Slack via their web application or download a desktop or mobile client.

Slack channels

By default you will be added to the #general channel, which is the general-purpose discussion chat. Other more topic-specific channels can be selected in the channels menu.

Setting up your Slack profile 

Once you are registered for Slack, you may customize your profile through the Slack website. There you can set your name and select your avatar. 

Slack help

If you have any questions, please refer to the Help Center documentation. Within Slack, please use #general channel for support.

Mailing list 

Subscribe to the mailing list via



Basebox is the BISDN controller package for data center networks with the following combinable elements:

  • The BISDN Linux Distribution is a Yocto-based operating system for selected whitebox switches
  • baseboxd is a controller daemon integrating whitebox switches into Linux
  • The CAWR controller (Capability AWare Routing) is an optional shim OpenFlow controller that creates a giant switch abstraction from a set of whitebox switches. It implements multi-path routing and multi-chassis link aggregation
  • OpenStack integration of baseboxd can be done via a Neutron ML2 plugin

Basebox can either run directly on the switch or in a separate controller machine. The solution addresses issues of orchestration, flexibilization, high availability and further automation in various scenarios. 

Please find the installation guide, API definitions and additional resources here.


Commercial support 

Get free community support in our Slack community, or a paid commercial support plan. 

If you have purchased a support contract with your Basebox instance, please use our Support platform

  • Our support team is available weekdays 9 a.m. – 5 p.m. CET
  • Next business day response
  • Developer-led support from the team that built Basebox 
  • Incident tracking with Freshdesk  




If you would like to visit us…

… our office is located in Berlin-Tiergarten, in close proximity to Potsdamer Platz:
Please find our offices at OpenStreetMap.


Körnerstraße 7-10, Aufgang A
10785 Berlin, Germany

Geschäftsführung: Dr. Hagen Woesner, Andreas Köpsel
Amtsgericht Berlin Charlottenburg, HRB 141569B
USt-ID DE283257294
D-U-N-S Nr. 342618395
Email: info<a>
Tel: +49 30 610 816 100


© OpenStreetMap contributors