mirrors
/
AdGuardHome
mirror of https://github.com/AdguardTeam/AdGuardHome.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

v0.9

hmage 2018-10-16 23:54:19 +03:00
parent a24fbb09b9
commit 60c13a3961
1 changed files with 24 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
VPS.md

@ -7,31 +7,31 @@ First let's ensure that your VPS has necessary minimal requirements, run this as
apt-get install sudo nano bind9-host apt-get install sudo nano bind9-host
``` ```
Go to [AdGuard DNS page](https://github.com/AdguardTeam/AdGuardHome#installation) and download binaries for your architecture (64-bit Linux in this example). Go to [AdGuard Home page](https://github.com/AdguardTeam/AdGuardHome#installation) and download binaries for your architecture (64-bit Linux in this example).
As of the time of writing, the latest version is v0.1 As of the time of writing, the latest version is v0.9
To download AdGuard DNS and unpack it execute following commands: To download AdGuard Home and unpack it execute following commands:
```bash ```bash
wget https://github.com/AdguardTeam/AdGuardHome/releases/download/v0.1/AdguardDNS_0.1_linux_amd64.tar.gz wget https://github.com/AdguardTeam/AdGuardHome/releases/download/v0.9/AdGuardHome_v0.9_linux_amd64.tar.gz
tar xvf AdguardDNS_0.1_linux_amd64.tar.gz tar xvf AdGuardHome_v0.9_linux_amd64.tar.gz
``` ```
You can find out the directory where you've unpacked it to by running these commands: You can find out the directory where you've unpacked it to by running these commands:
```bash ```bash
cd AdguardDNS cd AdGuardHome
pwd pwd
``` ```
In this example it is `/root/AdguardDNS`, now let's make it run on VPS boot: In this example it is `/root/AdGuardHome`, now let's make it run on VPS boot:
```bash ```bash
sudo nano /etc/systemd/system/adguard-dns.service sudo nano /etc/systemd/system/adguard-home.service
``` ```
A file will be opened, fill the file contents with this text: A file will be opened, fill the file contents with this text:
```ini ```ini
[Unit] [Unit]
Description=AdGuard DNS Description=AdGuard Home
After=syslog.target After=syslog.target
After=network.target After=network.target
@ -39,20 +39,20 @@ After=network.target
Type=simple Type=simple
User=root User=root
Group=root Group=root
WorkingDirectory=/root/AdguardDNS WorkingDirectory=/root/AdGuardHome
ExecStart=/root/AdguardDNS/AdguardDNS --host 0.0.0.0 ExecStart=/root/AdGuardHome/AdGuardHome --host 0.0.0.0
Restart=always Restart=always
[Install] [Install]
WantedBy=multi-user.target WantedBy=multi-user.target
``` ```
Note that I've used `/root/AdguardDNS` in that file, replace both instances with your own values there. Write to the file and close it. Note that I've used `/root/AdGuardHome` in that file, replace both instances with your own values there. Write to the file and close it.
After you're done with that, let's enable and start AdGuard DNS: After you're done with that, let's enable and start AdGuard Home:
```bash ```bash
sudo systemctl enable adguard-dns sudo systemctl enable adguard-home
sudo systemctl start adguard-dns sudo systemctl start adguard-home
``` ```
You can verify that it's working properly by running this command: You can verify that it's working properly by running this command:
@ -71,26 +71,26 @@ Host doubleclick.net not found: 3(NXDOMAIN)
``` ```
## Visit the web interface ## Visit the web interface
You can access your AdGuard DNS web interface on port 3000 by typing this in your browser — `http://1.2.3.4:3000/` You can access your AdGuard Home web interface on port 3000 by typing this in your browser — `http://1.2.3.4:3000/`
Replace 1.2.3.4 with the IP address of your VPS. Replace 1.2.3.4 with the IP address of your VPS.
## Configure your devices to use your AdGuard DNS ## Configure your devices to use your AdGuard Home
Now, once you've established that AdGuard DNS works on your VPS, you can use it on your machine by changing system DNS settings to use your VPS's public IP address. Now, once you've established that AdGuard Home works on your VPS, you can use it on your machine by changing system DNS settings to use your VPS's public IP address.
## (optional) Password-protect web interface ## (optional) Password-protect web interface
You have an option to password-protect your AdGuard DNS's web interface so only you can access it. You have an option to password-protect your AdGuard Home's web interface so only you can access it.
To do so, stop it first: To do so, stop it first:
```bash ```bash
sudo systemctl stop adguard-dns sudo systemctl stop adguard-home
``` ```
Then edit `/root/AdguardDNS/AdguardDNS.yaml` (substitute this path with your own as appropriate): Then edit `/root/AdGuardHome/AdGuardDNS.yaml` (substitute this path with your own as appropriate):
```bash ```bash
sudo nano /root/AdguardDNS/AdguardDNS.yaml sudo nano /root/AdGuardHome/AdGuardHome.yaml
``` ```
Find lines containing `auth_name: ""` and `auth_pass: ""` and replace them with username and password: Find lines containing `auth_name: ""` and `auth_pass: ""` and replace them with username and password:
@ -101,9 +101,9 @@ auth_pass: "your-secret-password"
Substitute name and password with your own, of course. Substitute name and password with your own, of course.
After you're done editing, save the file and start your AdGuard DNS again: After you're done editing, save the file and start your AdGuard Home again:
```bash ```bash
sudo systemctl start adguard-dns sudo systemctl start adguard-home
``` ```
After that, visiting web interface in a browser will require entering username and password. After that, visiting web interface in a browser will require entering username and password.