2020-07-13 05:37:04 +00:00
# udm-utilities [](https://join.slack.com/t/boostchicken/shared_invite/zt-fcjszaw4-2ZuNFxIQnrpjxixnm17LXQ)
2020-07-06 05:32:35 +00:00
2020-07-11 07:21:11 +00:00
A collection of things to enhance the capabilities of your Unifi Dream Machine or Dream Machine Pro.
## Contributing
2020-07-13 05:37:04 +00:00
2020-07-11 07:21:11 +00:00
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!
2020-05-31 13:56:48 +00:00
2020-07-05 20:54:53 +00:00
## General Tools
2020-07-13 05:37:04 +00:00
2020-08-27 09:46:17 +00:00
### suricata
Run an updated version of suricata and apply custom rules that survive reboot
2020-05-31 13:56:48 +00:00
### on-boot-script
2020-08-26 10:53:50 +00:00
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 ](https://github.com/boostchicken/udm-utilities/blob/master/on-boot-script/README.md ).
2020-07-06 05:33:20 +00:00
**It enables complete customization of your UDM/P and fills the gap that config.gateway.json left behind.**
2020-05-31 13:56:48 +00:00
2020-07-05 20:54:53 +00:00
### python
2020-07-13 05:37:04 +00:00
2020-07-05 20:54:53 +00:00
If you need python3 on your UDM, generally not recommended, can always use it in unifi-os container
2020-07-10 03:28:49 +00:00
## VPN Servers / Clients
### wireguard-go
2020-07-13 05:37:04 +00:00
2020-07-10 03:28:49 +00:00
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.
2020-07-05 20:54:53 +00:00
## DNS Providers
2020-08-26 10:53:50 +00:00
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 ](https://github.com/boostchicken/udm-utilities/tree/master/on-boot-script ) and [dns-common ](https://github.com/boostchicken/udm-utilities/tree/master/dns-common/on_boot.d ). Then, follow the guides below to setup either Pi-Hole, NextDNS, or AdGuard Home.
2020-07-13 05:37:04 +00:00
2020-06-28 13:02:50 +00:00
### dns-common
2020-08-26 10:53:50 +00:00
Base configuration for DNS server containers, both IPv4 and IPv6. Utilizes MacVLAN CNI plugins to completely isolate the network stack.
2020-06-28 13:02:50 +00:00
2020-05-31 13:56:48 +00:00
### run-pihole
2020-07-13 05:37:04 +00:00
2020-07-05 20:54:53 +00:00
Run pihole on your UDM with podman.
2020-06-05 03:50:14 +00:00
2020-06-05 04:53:50 +00:00
### nextdns
2020-07-13 05:37:04 +00:00
Run NextDNS on your UDM with podman.
2020-06-05 04:53:50 +00:00
2020-06-14 14:43:31 +00:00
### AdguardHome
2020-07-13 05:37:04 +00:00
2020-07-05 20:54:53 +00:00
Run AdguardHome on your UDM with podman.
2020-07-07 05:44:54 +00:00
## Cool projects you can use with this
2020-07-13 05:37:04 +00:00
### multicast-relay
2020-07-11 07:22:48 +00:00
2020-07-13 05:37:04 +00:00
< 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.
2020-07-07 05:44:54 +00:00
### ntopng
2020-07-13 05:37:04 +00:00
< https: / / github . com / tusc / ntopng-udm >
2020-07-11 07:22:48 +00:00
2020-07-07 05:44:54 +00:00
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.
2020-07-11 22:13:34 +00:00
### LetsEncrypt SSL Certs
2020-07-13 05:37:04 +00:00
< https: / / github . com / kchristensen / udm-le >
2020-07-11 22:13:34 +00:00
Provision and renew LetsEncrypt SSL certs from your UDM/P
2020-09-10 04:45:29 +00:00
### OpenConnect VPN
< https: / / github . com / shuguet / openconnect-udm >
2020-09-10 04:45:45 +00:00
OpenConnect VPN Client for the UniFi Dream Machine Pro (Unofficial)
