https://github.com/topscoder/nordvpn-udm
https://github.com/topscoder/nordvpn-udm
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/topscoder/nordvpn-udm
- Owner: topscoder
- Created: 2021-10-02T09:42:46.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-23T07:00:25.000Z (almost 3 years ago)
- Last Synced: 2025-05-05T08:41:16.398Z (about 1 year ago)
- Language: Shell
- Size: 464 KB
- Stars: 10
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# NordVPN on Unifi Dream Machine (Pro)
## Foreword
This repo is forked from [SierraSoftworks/tailscale-udm](https://github.com/SierraSoftworks/tailscale-udm) which allows to use a Tailscale instance on your UDM / UDM Pro. What's cool also is his approach persists even after a reboot of your UDM.
## What is this?
This repo contains the scripts necessary to setup a [NordVPN](https://www.nordvpn.com/) connection on your [Unifi Dream Machine](https://unifi-network.ui.com/dreammachine) (UDM / UDM Pro).
It does so by piggy-backing on the excellent [boostchicken/udm-utilities](https://github.com/boostchicken/udm-utilities)
to provide a persistent service and runs using the OpenVPN service.
## Instructions
### Prerequisites
- You need to be able to connect to your UDM / UDM Pro via SSH in order to run this installer.
- Go to UDM Home
- Click "Settings"
- Click "System"
- Scroll Down to the bottom of the list
- Click select "SSH", agree to the license
- Set a password
- You need an OpenVPN configuration file (.ovpn) from NordVPN.
You can do so by downloading a configuration file at the [NordVPN Server Tools](https://nordvpn.com/servers/tools/) page.
### Install NordVPN
1. Connect to your UDM using SSH
```sh
ssh root@
```
1. Follow the steps to install the boostchicken `on-boot-script` [here](https://github.com/boostchicken/udm-utilities/tree/master/on-boot-script).
1. Run the installer script to install `nordvpn` and the startup script on your UDM.
```sh
curl -sSL https://raw.githubusercontent.com/topscoder/nordvpn-udm/main/installer.sh | sh
```
1. Follow the on-screen steps to configure `nordvpn` and connect it to your network.
1. How to run on boot
```sh
https://github.com/peacey/split-vpn#how-do-i-run-this-at-boot
```
## Advanced configuration(s)
You want to be in full control of your network packets, bits and bytes? Sure you can. Find the split-vpn config file at `on_boot.d/10-nordvpn.conf` to go crazy ;-)
## Contributing
There are clearly lots of folks who are interested in running an OpenVPN connection on their Unifi gear. If
you're one of those people and have an idea for how this can be improved, please create a
PR and we'll be more than happy to incorporate the changes.