Skip to content
Pocket Homelab
Get the app

The Home screen

The dashboard: a pinned header banner, issue chips, and a grid of half- and full-width cards that each load independently.

iPhone
On this page

Home is the first tab and the app’s dashboard. It is a scrolling grid of cards, one per configured service, with an optional status banner pinned above it.

Home screen with a status banner, hero gauges and half-width tilesHome screen with a status banner, hero gauges and half-width tiles
Home with the System status banner, the Server and NAS gauges, and half-width tiles.

Anatomy

  1. Pinned header: a full-width capsule summarising one thing you care about (see below).
  2. Getting started: on a new setup, a card with the next few steps until they are done or you press Hide.
  3. Top row: the title Home, a magnifying glass that opens search, a bell showing the app badge total, and Edit Now.
  4. Issue chips: a strip of red and orange capsules, rendered only when something is actually wrong.
  5. Cards: half-width tiles pair up two per row; full-width cards stand alone and show more detail.
  6. Footer: up to two inline errors, then Updated 14:32 from the most recent stats snapshot.

Every row loads independently

Each card runs its own request and settles the moment that request returns. A slow Jellyfin never holds up your monitors. While a card reloads it keeps the value it already had, and if the request fails the old value stays put with a small red error line underneath it, the list never blanks.

Partially failed server stats are “filled” from the previous snapshot, so a blip does not replace your numbers with dashes. Cards with no value yet show a skeleton bar, and tiles reserve two caption lines so heights never jump.

A service that keeps failing is skipped for a while (60 seconds after the first miss, then 120, then 240) so its timeouts do not slow every refresh. Its last value and error stay on the card, and a pull-to-refresh, a return to the app or a settings change asks it again at once.

The pinned header

Settings → App → Home layout → Pinned header picks one banner, filtered to services you actually have. The default is System status, which reports both what is wrong and whether the checks behind it are current:

Banner Means
“Health checks passed” (green) Every configured health source answered recently and nothing is wrong.
“2 issues” (red) Something is wrong. “· checks incomplete” is added while a source is not current.
“Checking your homelab…” The first checks are still running.
“Health checks are stale” (orange) A source’s last check failed, or its last good answer is older than two normal refreshes.
“Health checks unavailable” (orange) A source’s check failed and it has not answered once since your settings last changed.
“No health checks configured” None of the health sources below is set up.

The health sources are Server & NAS, Monitors, AdGuard, Disk health and Backups, whichever you have. Tapping the banner opens Health checks: the issues, then each source as Up to date, Stale, Unavailable or Checking… with its Last successful check. A last known reading is not proof that a service is healthy now, so a cached number never counts as a passed check.

Other choices include:

Header Example
Server CPU, temperature & RAM CPU 24% · 48° · load 0.52 · 12.3 GiB RAM free
NAS storage tank 62% used · 4.20 TB free
Now playing alice watching The Expanse · +1
AdGuard Protecting · 1,240 blocked (10.0%)
Speedtest ↓ 300 ↑ 95 Mbps · 8 ms
This month’s spend Spent 650 BAM this month · next: Netflix
Latest alert Backup completed · 5 min ago · 3 new
Tasks due today 2 overdue · 1 due today
Next release Dune: Part Two · Friday

Choose None to hide the banner entirely.

Issue chips

The chips appear only when there is something to report, and each one is a link to the screen that can fix it:

Chip Colour Goes to
3 monitors down red Monitors
Pool tank degraded red NAS
SMART: 2 warnings red Disks
Backups need attention orange Backups
AdGuard paused orange AdGuard
CPU 92% orange Server
CPU 84° orange Server

Cards

Cards come in two sizes. Half cards are stat tiles: icon, title, a big value and up to two caption lines. Full cards are wider and add a details column of up to four lines. Server and NAS use a hero gauge, a 60-point progress ring with the headline value inside it.

A few cards are always full width: Issue chips, Open in Browser and Web search. Jellyfin, Photos and Money default to full width; everything else defaults to half.

Cards are only available when their service is configured. Issue chips additionally needs at least one issue, Photos needs something to show (memories for today, or recent photos), Open in Browser needs at least one link, and Notes needs the Notes app on your Nextcloud (see Nextcloud Notes).

What a card can show

Most cards offer more than one headline under Show on this card:

  • Server: CPU usage (default), RAM usage, CPU temperature.
  • NAS: Storage used (default), Free storage.
  • Downloads: Overview (default), Active transfers, Download speed, Upload speed.
  • AdGuard: Blocked percentage (default), Blocked requests, Total requests.
  • Speedtest: Download speed (default), Upload speed, Latency.
  • Money: This month’s spending (default), Total account balance, Upcoming bills.
  • Photos: On This Day (default), Recent photos.
  • Tasks: Overview, All open tasks, Overdue tasks.
  • Alerts: Unread count (default), Latest message.

Show supporting details turns the caption and detail lines off for a quieter card. On the Money card, Hide values on Home shows •••• instead of the amounts, and search leaves transaction amounts out; the full values stay visible inside Money.

Opening a card

Tapping a card opens its screen on Home, with the Back button to return, even when that screen also has a tab. The Photos card opens Photos on what it shows: today’s memories, or your recent photos.

Long-press a card for Edit dashboard, Edit card and Hide card. With Nextcloud Notes available there is also Notes about this: the notes that mention that card, and Write a note about this, which starts a note with a link back to it. See Nextcloud Notes.

Editing the layout

  1. Tap Edit Now (or long-press any card → Edit dashboard).
  2. Cards start to wobble. Hold and drag one to move it; use the corner arrows to switch between half and full width.
  3. The − badge hides a card. The ellipsis menu offers Move earlier / Move later.
  4. Add cards opens the library: Available cards you can toggle on, and greyed Unavailable services.
  5. Select Done, or just switch tabs.

Hidden and unconfigured cards keep their saved position, so re-adding a card puts it back where it was with its settings intact. Settings → App → Home layout has the same controls as a list, plus Restore default layout.

Empty, paused and offline states

With nothing configured, Home is the welcome screen: Look around first, Connect a service and Bring your configuration. See Install.

On the free plan with more than three services connected and none chosen yet, Home says Choose your three services (nothing is lost, the others stay saved and paused) with Choose services and See Pro.

When the device drops off the network, Home is replaced by Available offline: one row per service with downloaded content, each showing how many files and how much space. The banner above reads “Offline · Showing content saved on this device”. See Downloads & offline.