mirror of
https://github.com/pi-hole/docs.git
synced 2024-12-06 19:27:12 +01:00
Merge branch 'master' into drop
This commit is contained in:
@@ -37,7 +37,7 @@ Please make sure you fork the repo and change the clone URL in the example below
|
||||
git clone https://github.com/YOUR-USERNAME/docs
|
||||
cd docs
|
||||
sudo apt install python3-pip
|
||||
sudo pip3 install -r requirements.txt
|
||||
pip3 install -r requirements.txt
|
||||
```
|
||||
|
||||
- Running the docs server:
|
||||
|
||||
@@ -54,7 +54,7 @@ Label | Type | Allowed to by empty | Content
|
||||
`reply_time` | real | Yes | Seconds it took until the final reply was received
|
||||
`dnssec` | integer | Yes | Type of the DNSSEC status for this query (see [DNSSEC status](ftl.md#dnssec-status))
|
||||
|
||||
The `queries` `VIEW` is dynamically generated from the data actually stored in the tables `queries_storage` and the linking tables `domain_by_id`, `client_by_id`, `forward_by_id`, and `addinfo_by_id` (see below). The table `queries_storage` will contains integer IDs pointing to the respective entries of the linking tables to save space and make searching the database faster. If you haven't upgraded for some time, the table may still contain strings instead of integer IDs.
|
||||
The `queries` `VIEW` is dynamically generated from the data actually stored in the `query_storage` table and the linking tables `domain_by_id`, `client_by_id`, `forward_by_id`, and `addinfo_by_id` (see below). The table `query_storage` will contains integer IDs pointing to the respective entries of the linking tables to save space and make searching the database faster. If you haven't upgraded for some time, the table may still contain strings instead of integer IDs.
|
||||
|
||||
#### Data-dependent `additional_info` field
|
||||
|
||||
|
||||
@@ -46,7 +46,7 @@ sudo chmod +x /usr/local/bin/cloudflared
|
||||
cloudflared -v
|
||||
```
|
||||
|
||||
Note: Users [have reported](https://github.com/cloudflare/cloudflared/issues/38) that the current version of cloudflared produces a segmentation fault error on Raspberry Pi Zero W, Model 1B and 2B. As a workaround you can use an older version provided at <https://bin.equinox.io/a/4SUTAEmvqzB/cloudflared-2018.7.2-linux-arm.tar.gz> instead.
|
||||
Note: Users [have reported](https://github.com/cloudflare/cloudflared/issues/38) that the current version of cloudflared produces a segmentation fault error on Raspberry Pi Zero W, Model 1B and 2B. Currently, there is [no known workaround](https://github.com/pi-hole/docs/issues/710).
|
||||
|
||||
#### arm64 architecture (64-bit Raspberry Pi)
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ This is less convenient, so many users will simply decide to install Pi-hole and
|
||||
First, download the OpenVPN installer; make it executable, and then run it:
|
||||
|
||||
```bash
|
||||
wget https://git.io/vpn -O openvpn-install.sh
|
||||
wget https://github.com/Nyr/openvpn-install/raw/master/openvpn-install.sh
|
||||
chmod 755 openvpn-install.sh
|
||||
./openvpn-install.sh
|
||||
```
|
||||
|
||||
@@ -9,7 +9,9 @@ For each new client, the following steps must be taken. For the sake of simplici
|
||||
Script content:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
#! /usr/bin/env bash
|
||||
umask 077
|
||||
|
||||
ipv4="$1$4"
|
||||
ipv6="$2$4"
|
||||
serv4="${1}1"
|
||||
@@ -29,6 +31,7 @@ For each new client, the following steps must be taken. For the sake of simplici
|
||||
|
||||
echo "[Interface]" > "${name}.conf"
|
||||
echo "Address = $ipv4/32, $ipv6/128" >> "${name}.conf"
|
||||
echo "DNS = ${serv4}, ${serv6}" >> "${name}.conf" #Specifying DNS Server
|
||||
echo "PrivateKey = $(cat "${name}.key")" >> "${name}.conf"
|
||||
echo "" >> "${name}.conf"
|
||||
echo "[Peer]" >> "${name}.conf"
|
||||
@@ -48,12 +51,12 @@ For each new client, the following steps must be taken. For the sake of simplici
|
||||
Run the script like
|
||||
|
||||
```bash
|
||||
chmod +x /path/to/script.sh
|
||||
sudo -i
|
||||
cd /etc/wireguard
|
||||
umask 077
|
||||
|
||||
bash "10.100.0." "fd08:4711::" "my_server_domain:47111" 2 "annas-android"
|
||||
bash "10.100.0." "fd08:4711::" "my_server_domain:47111" 3 "peters-laptop"
|
||||
/path/to/script.sh "10.100.0." "fd08:4711::" "my_server_domain:47111" 2 "annas-android"
|
||||
/path/to/script.sh "10.100.0." "fd08:4711::" "my_server_domain:47111" 3 "peters-laptop"
|
||||
|
||||
exit
|
||||
```
|
||||
|
||||
@@ -14,6 +14,14 @@ server.port = 1080
|
||||
|
||||
In this case, port 1080 was chosen at random. You can use a custom port.
|
||||
|
||||
BUT ANY CHANGES MADE TO THIS FILE WILL BE LOST ON THE NEXT PI-HOLE UPDATE.
|
||||
|
||||
So if you want a permanent method of changing the lighttpd port and your lighttpd version >= 1.4.46, you can overwrite the port in: `/etc/lighttpd/external.conf` (note the different syntax!):
|
||||
|
||||
```lighttpd
|
||||
server.port := 1080
|
||||
```
|
||||
|
||||
Next, restart the lighttpd server with either of these commands:
|
||||
|
||||
```bash
|
||||
|
||||
@@ -28,7 +28,8 @@ The following operating systems are **officially** supported:
|
||||
| Ubuntu | 16.x / 18.x / 20.x /21.x | ARM / x86_64 |
|
||||
| Debian | 9 / 10 /11 | ARM / x86_64 / i386 |
|
||||
| Fedora | 33 / 34 | ARM / x86_64 |
|
||||
| CentOS | 7 / 8 | x86_64 |
|
||||
| CentOS | 7 | x86_64 |
|
||||
| CentOS Stream | 8 | x86_64 |
|
||||
|
||||
<!-- markdownlint-disable code-block-style -->
|
||||
!!! info
|
||||
|
||||
+1
-1
@@ -2,7 +2,7 @@ site_name: 'Pi-hole documentation'
|
||||
site_url: 'https://docs.pi-hole.net/'
|
||||
repo_url: 'https://github.com/pi-hole/pi-hole'
|
||||
edit_uri: '../docs/blob/master/docs/'
|
||||
copyright: 'Copyright © 2021 Pi-hole LLC'
|
||||
copyright:
|
||||
remote_branch: gh-pages
|
||||
theme:
|
||||
name: 'material'
|
||||
|
||||
@@ -1,8 +0,0 @@
|
||||
{% extends "base.html" %}
|
||||
|
||||
{% set extracopyright %}
|
||||
<br>
|
||||
<a href="https://www.netlify.com/" target="_blank" rel="noopener noreferrer">
|
||||
This site is powered by Netlify
|
||||
</a>
|
||||
{% endset %}
|
||||
@@ -0,0 +1,7 @@
|
||||
<div style="display:block">
|
||||
Copyright Pi-hole. Licensed under <a href="http://creativecommons.org/licenses/by-sa/4.0/" target="_blank" rel="noopener noreferrer">CC BY-SA 4.0</a>
|
||||
<br>
|
||||
<a href="https://www.netlify.com/" target="_blank" rel="noopener noreferrer">
|
||||
This site is powered by Netlify
|
||||
</a>
|
||||
</div>
|
||||
Reference in New Issue
Block a user