Manually Installing on OpenWrt

As of the release of 14.9.1, Speedify supports OpenWrt, the open source router operating system. There is an easy to use script that installs and configures Speedify correctly, which you should probably use.

Packages

Speedify provides two packages for Openwrt:

speedify : The core Speedify VPN service and CLI
luci-app-speedify : An optional addition of the Speedify tab in Luci

The speedify package installs a GNU libc-compatible runtime if one is not present and the luci-app-speedify package installs Nginx if not present. Installing a GNU libc runtime should not break existing packages. The Nginx web server is installed to secure our local WebSocket API. Installing Nginx may break packages that depend on uhttpd.

Device Support

Speedify on OpenWrt currently supports x86_64 (Intel or AMD) or aarch64 (Cortex a53 or a72) CPU architectures. Support for MIPS devices may arrive in the future.

This covers some popular devices like the Banana Pi and the Raspberry Pi.

The speedify package has been tested on a variety versions of OpenWrt from 19.07 through 23.05. The luci-app-speedify package has only been tested on OpenWrt 23.05.

The majority of our testing has been on for the Raspberry Pi 4 and 5, and the BananaPi R3. Other devices that have supported architectures should work, and we would like to hear if you have any issues.

Installation

Packages on OpenWrt are installed through the Opkg package manager. Packages may need to be reinstalled after a full system upgrade or a factory reset.

You may either download and copy the package onto your router or download the package directly onto your router. In either case, we recommend using the temporary filesystem /tmp to avoid stress on your storage medium.

Routers typically use SD cards for long-term storage. SD cards have a limited number of write cycles.

Prerequisites

You will need the default gateway and the architecture of the router.

The most common default gateway is 192.168.1.1. The default gateway may be printed somewhere on the router.

To find the Opkg-specific architecture of your router

opkg print-architecture | tail -n 1 | cut -d ' ' -f 2

Packages on OpenWrt use a more specific architecture than uname -m

Next, you need to get the installer packages onto your router, either by downloading them to the router directly while ssh'ed into the server, or by downloading the files to your computer and sftp'ing them over to the router.

Option 1: Download directly onto your router

There are OpenWrt packages available for the following architectures. Use the corresponding download link in the instructions below:

The optional Luci UI package is architecture independent:

https://downloads.speedify.com/luci-app-speedify_all.ipk

# Typically, this is root@192.168.1.1
ssh $routeruser@$routergateway
wget https://downloads.speedify.com/speedify_$opkg_architecture.ipk -O /tmp/speedify.ipk
# If you want the Luci package (recommended)
wget https://downloads.speedify.com/luci-app-speedify_all.ipk -O /tmp/luci-app-speedify_all.ipk

Option 2: Copy onto your router

# If not already installed, the router will require an SFTP server for scp to work
ssh $routeruser@$routergateway sh -C 'opkg update && opkg install openssh-sftp-server'
wget https://downloads.speedify.com/speedify_$opkg_architecture.ipk
scp speedify_$opkg_architecture.ipk $routeruser@$routergateway:/tmp/speedify.ipk
# If you want the Luci package (recommended)
wget https://downloads.speedify.com/luci-app-speedify_all.ipk
scp luci-app-speedify_all.ipk $routeruser@$routergateway:/tmp/luci-app-speedify_all.ipk

Install the Packages

ssh $routeruser@$routergateway opkg install /tmp/speedify.ipk
# If you want the Luci package (recommended)
ssh $routeruser@$routergateway opkg install /tmp/luci-app-speedify_all.ipk

If you had the Luci web admin panel open, then after installing luci-app-speedify for the first time, you will need to logout of Luci, then log back in, for the Speedify tab to be visible.

Now that Speedify is working, you can use the CLI or Luci to start configuring it.

Please contact us at support@speedify.com if you see issues.