Skip to content

Downloads

Albert López Brescó edited this page Apr 24, 2019 · 21 revisions

Open Overlay Router is available for Linux, OpenWrt routers, Android and iOS. You can get the source code to compile OOR for each of the platforms here.

Linux

Get the .zip with the latest available release here

OpenWrt

OpenOverlayRouter is officially available from OpenWrt repositories. To install the package:

  • opkg update
  • opkg install oor

If you want to use the last version of OpenOverlayRouter, you can find at this link OpenOverlayRouter packages precompiled for some of the most typical architectures of OpenWRT. If you don't find the package for your architecture, send us a mail with the architecture of your router and we will try to precompile it for you. The packages are precompiled against OpenWRT 18.06. If you need to compile OpenWRT for another version, you can find the instructions on how to build OpenWRT here

To install the package:

SSH into the router
opkg install http://http://www.openoverlayrouter.org/downloads/OpenWrt/1.3.0/<package_name>

Replace package_name with the name of the file associated with the architecture of your router

If you don't have OpenWRT installed in your router, you can check if your device is supported by OpenWRT in the following link. This link contains the supported routers by OpenWRT and the specific instructions for each one as well as the supported release versions.

Run the code:

Configure OOR using the configuration file located at /etc/config/oor

Configure the firewall of OpenWRT to accept traffic forwarding from WAN to LAN network.

Start or stop OOR using the following command: /etc/init.d/oor [start|stop]

There is also available an OpenWrt image pre-configured for easy home multihoming on certain router models. Multihoming enables bandwidth aggregation over several links and/or link backup. If you are interested, you can read all the details here.

Android

Open Overlay Router includes support for Android devices operating as LISP mobile nodes (LISP-MN). There are two implementations of Open Overlay Router merged in a single application, for rooted devices and for non-rooted devices. The application automatically selects the implementation to run according to the features of the device. It is expected that in the future the version executed in rooted devices will provide features beyond those available on the non-root devices, however on the current version there is just one root-only feature, support for IPv6 RLOCs. In both editions, there is a limit of one single EID (IPv4 or IPv6) mapped to one or more RLOC interfaces. Even though several interfaces can be managed by Open Overlay Router at the same time, they can only be used in an active-backup fashion (no more than one interface used at once).

OOR requires a device with Android 4.0 or higher. Please note that due to a bug on Android 4.4.0 and onwards, OOR will not work properly in no rooted devices with Android 4.4.0, 4.4.1, 4.4.2 or 4.4.3. The bug was fixed on Android 4.4.4. To ease the installation process we strongly recommend installing OOR through Google Play (search for “OpenOverlayRouter”), however you can also download a precompiled APK package file from the link below or compile the app from sources yourself. In any case, if you choose to install OOR without using Google Play, the device must be configured to allow the installation of packages from "unknown sources" (System Settings -> Security -> Device Administration)

WARNING

The software is provided as is without any warranty. Although the authors have attempted to find and correct any bugs in the free software application, the authors are not responsible for any damage or losses of any kind caused by the use or misuse of the application.

iOS

Open Overlay Router includes support for Apple iOS devices operating as LISP mobile nodes (LISP-MN). The OOR iOS app supports the following features:

  • LISP supported as a MN
  • NAT-Traversal support
  • Handover
  • Multiple interfaces support in an active-backup fashion (no more than one interface used at once).
  • IPv4 / IPv6 EIDs and IPv4 RLOCs

You can install the OpenOverlayRouter application for Apple iOS from Apple Store (search for “OpenOverlayRouter”)

If you are an apple developer, you can also compile the application from source code. You can find the code an instructions to compile it here.

OOR for iOS has been tested in iOS 11.3.1.

WARNING

The software is provided as is without any warranty. Although the authors have attempted to find and correct any bugs in the free software application, the authors are not responsible for any damage or losses of any kind caused by the use or misuse of the application.