4162127058
* Added container-common Initial release of container-common section that includes setting a limit of container log size any container can have, to prevent filling up UDM storage with excessive logging. * Update README.md Clarified description of max log size Co-authored-by: TRUPaC <trupac@cs-mapping.com.ua> |
||
---|---|---|
.github | ||
AdguardHome | ||
cloudflare-ddns | ||
cni-plugins | ||
container-common | ||
dns-common/on_boot.d | ||
homebridge | ||
nextdns | ||
on-boot-script | ||
python | ||
run-pihole | ||
suricata | ||
wireguard-go | ||
.gitignore | ||
LICENSE | ||
README.md |
udm-utilities
A collection of things to enhance the capabilities of your Unifi Dream Machine or Dream Machine Pro.
Contributing
Pull Requests welcome! If you use this functionality to do new cool stuff to your UDM/P please send a PR and share it with the community!
General Tools
suricata
Run an updated version of suricata and apply custom rules that survive reboot
on-boot-script
Do this first. Enables init.d style scripts to run on every boot of your UDM. Includes examples to run wpa-supplicant/eap-proxy and/or ntop-ng on startup. Follow this readme.
It enables complete customization of your UDM/P and fills the gap that config.gateway.json left behind.
container-common
Apply this after on-boot-script. Updates container defaults to maintain stable disk usage footprint of custom containers. Prevents logs filling up UDM storage full.
python
If you need python3 on your UDM, generally not recommended, can always use it in unifi-os container
VPN Servers / Clients
wireguard-go
Run a Wireguard client/server on your UDM/P. Utilizes wireguard-go, not linux kernel modules. The performance will take a hit due to that.
DNS Providers
Install a DNS server that functions as a network-wide ad and tracker blocker, and which can also securely proxy encrypted DNS requests to an upstream DNS provider. Begin by following the instructions to setup on-boot-script and dns-common. Then, follow the guides below to setup either Pi-Hole, NextDNS, or AdGuard Home.
dns-common
Base configuration for DNS server containers, both IPv4 and IPv6. Utilizes MacVLAN CNI plugins to completely isolate the network stack.
run-pihole
Run pihole on your UDM with podman.
nextdns
Run NextDNS on your UDM with podman.
AdguardHome
Run AdguardHome on your UDM with podman.
Cloudflare DDNS
Update your cloudflare domains from your UDM with podman.
Cool projects you can use with this
multicast-relay
https://hub.docker.com/r/scyto/multicast-relay
This is a docker container that implements https://github.com/alsmith/multicast-relay to provide mDNS and SSDP on a unifi dream machine. It will likely work on any multi homed host.
ntopng
https://github.com/tusc/ntopng-udm
Much better network stats for your UDM/P! Install this docker container and create an on_boot script to make sure it's always running.
LetsEncrypt SSL Certs
https://github.com/kchristensen/udm-le
Provision and renew LetsEncrypt SSL certs from your UDM/P
OpenConnect VPN
https://github.com/shuguet/openconnect-udm
OpenConnect VPN Client for the UniFi Dream Machine Pro (Unofficial)
Unifi API Browser
https://hub.docker.com/r/scyto/unifibrowser
This is a docker container that implements https://github.com/Art-of-WiFi/UniFi-API-browser to provide a graphical tool to inspect the data structures available via the unifi API. Great if you are using the REST API for your own puposes and want to explore. Works with multiple controler versions.