Skip to main content...

How WPSD Hostfiles Work

When you use your WPSD hotspot to connect to a YSF reflector, a DCS room, a DMR network, or a P25 talkgroup, you are picking from a list. That list – the names, IDs, addresses, and ports your hotspot uses to make those connections – comes from hostfiles.

What Is a Hostfile?

Hostfiles are plain-text data files, one per mode, that your WPSD device downloads automatically and stores locally. They are the backbone of every reflector and network list you see in your hotspot’s menus and dashboard. Without them, your hotspot would have nowhere to connect.

What Do Hostfiles Contain?

Different modes use different hostfile formats, but they all serve the same purpose: mapping a human-readable name or numeric ID to a network address so your hotspot knows where to connect.

Mode What the hostfile provides
YSF Reflector names, IP addresses, ports, and live connected-user counts
P25 Talkgroup IDs and reflector addresses
NXDN Talkgroup IDs and reflector addresses
D-Plus Reflector callsigns and IP addresses
D-Extra Reflector callsigns and IP addresses
DCS Reflector names and IP addresses
DMR Network names, IDs, IP addresses, and ports
NXDN ID Numeric NXDN radio IDs mapped to callsigns
DMR ID Numeric DMR radio IDs mapped to callsigns

The ID files (DMR ID, NXDN ID) are what allow your hotspot and linked systems to display a callsign next to an incoming transmission rather than just a raw number.

Talkgroup list files (for DMR, P25, and NXDN) are equally important: they map numeric talkgroup IDs to human-readable names. Without them, your dashboard would show a bare number like 3100 instead of BrandMeister Worldwide. WPSD downloads and updates these automatically alongside the other hostfiles, so your dashboard always displays meaningful talkgroup names rather than raw numbers.

Where Do Hostfiles Come From?

The canonical source of truth for digital voice hostfiles is DVRef, founded by Steve Miller (KC1AWV) and co-developed by KC1AWV and me (W0CHP). DVRef aggregates reflector and network information submitted by operators worldwide and is the registry that WPSD, Pi-Star, DVSwitch, and many other platforms draw from. Core DVRef team members include W0CHP (WPSD), Andy Taylor (MW0MWZ, Pi-Star), and Steve Zingman (N4IRS) and his brother Mike (N4IRR) (both of DVSwitch) – so the data flowing into your device ultimately traces back to a common authoritative source. Other prominent software that relies on DVRef data includes BlueDV, DroidStar, and SharkRF OpenSpot and M1KE devices.

RefCheck.Radio is a partner to DVRef, developed and hosted by me, W0CHP. DVRef uses the RefCheck.Radio API to perform live up/down validation of reflectors at registration time – so the moment a new reflector is added to DVRef, its reachability is confirmed. RefCheck.Radio also provides the ongoing hostfile scrubbing described in this document, as well as a public portal where anyone can see which reflectors are currently unreachable.

WPSD fetches its hostfiles from hostfiles.w0chp.net, the WPSD Hostfile Server. That server pulls from DVRef and RefCheck.Radio, processes the data, and publishes the final scrubbed files that your device downloads.

How WPSD Uses Hostfiles

Your WPSD device checks for updated hostfiles once per hour, but it will only download a new copy if its local files are more than 4 hours old. In practice, this means your device refreshes its hostfiles roughly every 4 hours.

Most other hotspot software updates hostfiles only once every 24 hours. WPSD’s 4-hour cycle is a deliberate differentiator – it means newly-added reflectors appear in your lists sooner, and reflectors that have gone offline are removed faster.

When new files are downloaded, WPSD updates its internal lists automatically. The next time you open a mode’s reflector selector, the updated list is what you see.

What Is Hostfile Scrubbing?

In an ideal world, every reflector listed in a hostfile would be online and reachable. In reality, reflectors go offline – operators retire them, servers crash, home internet connections fail – and no one removes them from the registry. The result is hostfiles full of dead entries that waste your time and clutter your menus.

Hostfile scrubbing solves this. Before the WPSD Hostfile Server publishes files to your device, it pulls scrubbed versions from RefCheck.Radio – a service that continuously polls every reflector in every hostfile to verify it is actually reachable. Reflectors that do not respond are removed before the file reaches your device.

The result: shorter lists, but ones where every entry actually works.

Which Modes Are Scrubbed?

Mode Scrubbed?
YSF Yes -- count field reflects live connected users
P25 Yes
NXDN Yes
D-Plus Yes
D-Extra Yes
DCS Yes
DMR No -- DMR networks require a personal DMR ID to check and are not mass-checked
DMR ID / NXDN ID No -- these are registry lookups, not connectivity checks

YSF – Live Connection Counts

YSF hostfiles include a field for connected-user count. Historically this was always 000 because it was never populated with real data. It now reflects the actual number of users connected to each reflector at the time it was last checked, giving you a live sense of activity before you connect.

How Often Does Everything Update? The Full Pipeline

Your hostfiles travel through a three-stage pipeline before reaching your device, and each stage runs on its own schedule:

flowchart LR
    A["RefCheck.Radio
Polls every reflector
for availability

Every 30 minutes"] B["WPSD Hostfile Server
Pulls from RefCheck,
builds & publishes
scrubbed hostfiles

Every 4h at :37"] C["Your WPSD Device
Checks hourly;
downloads only if
local copy is >4h old

~Every 4-5 hours"] A -->|"every 4h at :37"| B B -->|"within ~1h of publication"| C

What this means in practice:

  • When the WPSD Hostfile Server runs at :37, it is pulling availability data from RefCheck.Radio that is at most ~7 minutes old – the previous RefCheck sync ran at :30.
  • Your device picks up each new set of published files within roughly an hour of them being available on the server.
  • Worst case: the hostfiles on your device reflect availability data that is approximately 5 hours old. This has always been well within the norm for hostfile distribution – and remember, most other hotspot software only refreshes once every 24 hours.

Forcing an Immediate Update

If you need fresher data right now – say, a reflector you use has just come back online – you can force your WPSD device to re-download hostfiles immediately without waiting for the next automatic cycle:

Admin –> Advanced –> Tools –> Update Hosts Files

Keep in mind that forcing an update on your device only helps if the WPSD Hostfile Server has already published a new set of files since your last download. The server runs on its own 4-hour schedule regardless.

If you need to check whether a specific reflector is reachable right now, use the live validator at refcheck.radio – it performs an on-demand check without waiting for any scheduled cycle.

Why Did a Reflector I Use Disappear?

If a reflector that was previously in your list is no longer there, it failed its availability check and was removed from the published hostfile. Common reasons include:

  • The operator took it offline for maintenance
  • The operator has permanently shut it down
  • The server hosting it crashed or lost internet connectivity
  • A transient network issue occurred during the check window

In most cases, if the reflector comes back online, it will automatically reappear in the next published hostfile – no action needed on your end. If you believe a removal is in error, contact the reflector operator directly to confirm it is running and reachable from the internet.

Nothing Else You Need to Do

No configuration changes are required on your WPSD device. Everything described here happens automatically in the background. Your device will continue to fetch updated hostfiles on its normal schedule, and those files will now be cleaner and more accurate than before.


Hostfile scrubbing and availability checking powered by RefCheck.Radio – W0CHP.

Last Revision: 2026-06-26 -- Document Version: fadd16e
Permanent Link: <https://w0chp.radio/articles/how-wpsd-hostfiles-work/>