# Alpine Linux Home Router

A small set of shell scripts you can drop into `/etc/local.d/`
that will turn an Alpine Linux machine into a home router. The functionality
includes IPv6 via DHCPv6 and port dynamic forwarding via miniupnpd ( optional )

## Configuration

All major configuration options are in `/etc/local.d/vars.sh`

Simply adjust `wan_hwaddr` if yo so desire, set the `wan` and `lan` interfaces
and the scripts will take care of the rest.

The `radvd` daemon will automatically be started by the `dhcpcd` hook.

`dnsmasq` for DHCPv4 on the LAN needs to be enabled by hand.

`miniupnpd` is not enabled by default, though it is configured.

## Installation

On a complete Alpine Linux install, copy the files to `/etc/local.d`,
then run:

```
# apk add iptables ip6tables dnsmasq miniupnpd dhcpcd radvd curl
# rc-update add local boot
# rc-update add dnsmasq default
```

For a basic configuration. Reboot for it to take effect. It's wise to disable
all other network configuration on the box before you do so.

For a more in-depth tutorial [see my blog post](https://riedstra.dev/2022/02/alpine-linux-home-router).

## UPNP Considerations

UPNP can be dangerous, if you don't trust the devices on your network turn it
off, or block the port to all but the devices you trust.