Skip to content

Requirements

  • Ubuntu 24.04 LTS, x86-64, a fresh installation.
  • Root access (sudo).
  • Internet access during the installation: the installer downloads Ubuntu packages with apt.
  • The system clock should be right. The router serves time to its OLTs with chrony.

Plan at least two roles for the ports:

  • Uplink. Toward your border router or the internet. It carries the router’s public addresses and the default route. Two or more ports can form a bond (LACP).
  • Access. Toward the OLTs. The OLT’s S-VLAN (QinQ) and the OLT’s management network ride on it. A bond works here too.

A separate management port is useful but not required. If the server has a BMC with a USB network link (often usb0), the router shows it as the BMC’s link and never manages it as a port.

install.sh installs these Ubuntu packages by itself:

php-cli php-sqlite3 python3 git curl tar cron iproute2
isc-dhcp-server radvd
iptables iptables-persistent netfilter-persistent
rrdtool msmtp-mta snmpd snmp fail2ban chrony

PHP stays installed only as a fallback. With the dtvsold binary in place, nothing runs PHP in normal operation.

  • The router software (a release tarball or the repository).
  • The dtvsold daemon and the OLT driver for your vendor. Both are licensed binaries and are not part of the public release.
  • A router id and an enrolment token for the licence.

Have these ready:

  • The uplink port name, its IPv4 address with prefix, the gateway, and DNS servers.
  • The networks your NOC and your billing come from. Only these can reach the API and the monitor.
  • For each OLT: its management address, a login, and the S-VLAN this router uses on it.

This site was written with the help of AI and checked by our team.