tihole app icon
tihole
Pi-hole v6 remote control · iPhone and iPad

Your Pi‑hole,
in your pocket.

tihole is a native app for Pi-hole v6. Watch every DNS query live, swipe to allow or block a domain, pause blocking for a few minutes, and manage lists, clients, local DNS and every FTL setting, on as many Pi-holes as you run.

$4.99 once · iOS 17 or later · No subscription, ads or tracking

tihole dashboard on iPhone: total queries, blocked, active
        clients, gravity domains, CPU, memory, temperature and load tiles,
        a health warning and a queries over time chart.
01 · Screens

Every Pi‑hole screen, made for touch.

Real captures of the app, taken by its UI test against a mock Pi-hole. Not mockups.

02 · Get started

Three steps to your first Pi‑hole.

  • 1
    Install tihole
    From the App Store on iPhone or iPad (iOS 17 or later), or build it yourself from the source with Xcode.
  • 2
    Create an app password
    In Pi-hole's web interface, open Settings → Web interface / API and generate an app password.
  • 3
    Add your Pi-hole
    Give it a name, its address and the app password. Add more Pi-holes any time from Settings.
03 · Numbers

Small app, whole Pi‑hole.

Tabs
5tabs
for all ten of the TUI's screens
Allow or block
1swipe
straight from the query log
Pi-holes
∞instances
switch from any tab
Tracking
0trackers
talks only to your Pi-holes
04 · Architecture

How it talks to Pi‑hole.

The same layering as the terminal app: the client knows nothing about the UI, and the UI never reaches past the client.

  • ▤
    SwiftUI screens
    Five tabs. Load in .task, poll only while visible and in the foreground.
    view
  • ◎
    AppModel
    Saved Pi-holes, the active client, theme and blocking status.
    state
  • ⇄
    PiholeKit
    An actor with one method per FTL endpoint. One shared login on a 401.
    http
→taps
←json
  • ⌂
    Pi-hole v6 · FTL
    The official REST API at /api with X-FTL-SID sessions.
    api
  • ⚿
    Keychain
    One password per Pi-hole, this device only.
    secure
  • ✓
    Ship
    Every TestFlight build has a GitHub build provenance attestation.
    ci
05 · Gestures

Where the TUI has keys, the app has swipes.

  • ←
    Swipe a query left
    Allow or block its domain
    Queries
  • ⏻
    Tap the blocking pill
    Disable for 5, 10 or 15 minutes, or until you turn it back on
    Every tab
  • ⌄
    Tap the Pi-hole name
    Switch to another Pi-hole
    Every tab
  • →
    Swipe a rule right
    Enable or disable it
    Domains · adlists · groups
  • ←
    Swipe a row left
    Delete it
    Lists · local DNS · clients
  • ↓
    Pull down
    Refresh
    Any list
  • ⌕
    Search
    Filter domains or settings as you type
    Queries · FTL config
  • ✕
    Swipe a diagnosis message
    Dismiss it
    System
06 · Releases

What's new.

From the changelog.

07 · FAQ

Questions.

?Does tihole need Pi-hole v6?
Yes. tihole speaks the Pi-hole v6 REST API and its sessions. It does not support the v5 API.
?How much does it cost?
$4.99, once. No subscription, no in-app purchases and no ads. Every feature on this page is included.
?How do I sign in?
With an app password from Pi-hole's web interface. tihole keeps it in the iOS Keychain, on that device only, and only ever sends it to that Pi-hole.
?What does swipe to allow or block do?
In the query log, swiping a query offers Allow and Block. Each adds an exact rule for that domain, the same call the web interface makes. Regex and group-scoped rules are on Lists → Domains.
?Can I reach my Pi-hole away from home?
Yes, if your phone can reach it: over a VPN such as WireGuard or Tailscale, by its LAN name or IP, over HTTPS or plain HTTP. Self-signed certificates work once you turn off "Verify TLS certificate" for that Pi-hole.
?Does it phone home?
No. There are no accounts, analytics, ads or crash reports. The only traffic is to the Pi-holes you add. See the privacy policy.
?Can I change the theme?
Gloss is the default. Settings also has Deep Night, Light Luxury, Pi-hole Classic and Auto, which follows the system. Try them with the menu at the top of this page.
?Is there a terminal version?
Yes, it came first. tihole is the keyboard-driven TUI this app was ported from.