# The whole home from one router.

Put Fenris on the router, and everything behind it is bonded: laptops, phones, the TV. Nothing is installed on any of them.

_Router · OpenWrt and Linux · Your server_ 

Everything at home reaches the router over ordinary Wi-Fi and cable. The router, where Fenris runs, carries it over every link to your server.

**Fig. 1** Nothing is installed on the devices at home. They connect as they always have.

## What happens

1. Fenris runs on the router, as an OpenWrt package, or on a Linux box such as a Raspberry Pi.
2. Every WAN the router has becomes a link. Fibre, a 5G modem, a tethered phone: each with its own way out.
3. Devices at home connect as they always have. The router carries their traffic over every link to your server.
4. The kill switch holds from early boot, for the router and for everything behind it.
5. The router has a page of its own on your LAN. Home, Links, Activity, Usage, Servers, Rules, Diagnostics and Settings, sized for a phone too.

## What it costs

One small processor does the work for the whole house.

**The router’s processor**

Every packet, for every device, is sealed on the router. A small router’s processor can set the ceiling before your links do.

**A router that can run it**

OpenWrt 25.12 or newer, or Linux 5.15 or newer, on a 64-bit ARM or x86 chip. A MIPS or 32-bit router can’t run it.

**Everything goes through it**

Every device’s traffic takes the tunnel unless you set it to go direct. A site that distrusts your server’s address has to be listed.

**Away from home**

A laptop or a phone that leaves the house leaves the router’s links behind. Fenris on the device itself bonds its own.

## Turn it on

Install it on the router, then join your server.

| To                               | Command line                                                               | Router UI                            |
| -------------------------------- | -------------------------------------------------------------------------- | ------------------------------------ |
| Join your server, on OpenWrt     | fenris-client join \--state /etc/fenris/state '<invite link>'              | LuCI, Services, Fenris               |
| Install and join, on a Linux box | curl \-fsSL https://dl.fenris.network/get.sh \| sh \-s \-- '<invite link>' | On the router                        |
| See every link, side by side     | fenris links                                                               | Links                                |
| Watch it, redrawn every second   | fenris top                                                                 | Home                                 |
| Let a device at home go direct   | fenris settings \--direct-devices 192.168.1.40                             | Settings, Direct, outside the tunnel |
| Find where the router’s page is  | fenris ui                                                                  | On the router                        |

### Where to find it

**Router UI** Home. Every link, its share, and the speed over all of them as one.

The router’s own page, Home, with example data: connected, two of three links up, the speed over both as one, and each link with its share.

**On a phone** Rules. The same pages, sized for a phone.

The router’s Rules page, with example data: the profile, the spreading switches and how each kind of traffic is handled.

**The console** The router’s page on your server.

The console’s page for one device, with example data: its state, its throughput, the drops its links absorbed, and each link side by side.

**The product** Three of its own screens, with example data.

## What it keeps

Your server counts the router as one device: one set of links, one record of sessions, one daily total. It keeps nothing by laptop, phone or TV.

[Everything your server keeps](https://fenris.network/privacy#kept)

## Where it stops

**Your provider’s box**

A locked box from your provider can’t run Fenris. Keep it, and plug it into a Fenris router as one of its links.

**Links of their own**

Each link needs its own default route. Two cables to the same line upstream are one link.

**Wi-Fi inside the house**

Fenris bonds the router’s links to the internet. It does not make the Wi-Fi in your home reach further.

## Related
