Skip to content

Clarify client description priorities on the groups/client interface #3521

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 20, 2025
Merged

Clarify client description priorities on the groups/client interface #3521

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 10 additions & 9 deletions groups-clients.lp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,15 +46,16 @@ mg.include('scripts/lua/header_authenticated.lp','r')
<div class="row">
<div class="col-md-12">
<p>You can select an existing client or add a custom one by typing into the field above and confirming your entry with <kbd>&#x23CE;</kbd>.
Multiple clients can be added by separating each client with a space or comma.</p>
<p>Clients may be described either by their IP addresses (IPv4 and IPv6 are supported),
IP subnets (CIDR notation, like <code>192.168.2.0/24</code>),
their MAC addresses (like <code>12:34:56:78:9A:BC</code>),
by their hostnames (like <code>localhost</code>), or by the interface they are connected to (prefaced with a colon, like <code>:eth0</code>).
</p>
<p>Note that client recognition by IP addresses (incl. subnet ranges) are preferred over MAC address, host name or interface recognition as
the two latter will only be available after some time.
Furthermore, MAC address recognition only works for devices at most one networking hop away from your Pi-hole.
Multiple clients can be added by separating each client with a space or comma. Clients may be described either by their
<ol>
<li>IP addresses (IPv4 and IPv6 are supported),</li>
<li>IP subnets (CIDR notation, like <code>192.168.2.0/24</code>), their</li>
<li>MAC addresses (like <code>12:34:56:78:9A:BC</code>), by their</li>
<li>hostnames (like <code>localhost</code>), or by the</li>
<li>interface they are connected to (prefaced with a colon, like <code>:eth0</code>).</li>
</ol>
The first match (from top to down) wins. Note that client recognition by host name or interface recognition as
the two latter may only be available after some time. Furthermore, MAC address recognition only works for devices at most one networking hop away from your Pi-hole.
</p>
</div>
</div>
Expand Down