← Directory

Chirp-Headscale

Optional companion to Chirp: a self-hosted Headscale (Tailscale control server) so Chirp stations outside your home network can reach your Chirp server…

  • Network Services
  • Tools & Utilities
Optional companion to Chirp: a self-hosted Headscale (Tailscale control server) so Chirp stations outside your home network can reach your Chirp server privately. Creates its own reusable key on first start and hands it to the Chirp container.

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

45/100 Fair

Maintained
75last commit 2 days ago
Popular
61 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
1
Open issues
0
Last commit
2026-10-20
Activity
rising

Checked 2 days ago - source: GitHub (joshsalvi/chirp)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 2 days ago - source: Docker Hub image tags and published docs

First-install notes

  • When to enable Headscale is an optional, opt-in container: only deploy it if you have Chirp listening stations on networks other than your Chirp server's own LAN. It auto-generates a reusable auth key on first start and passes it to the Chirp container, so no manual key setup is required. source

Fetched yesterday - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Is Chirp-Headscale required for a self-hosted Chirp setup?

No, it is an optional companion to Chirp.

How does Chirp-Headscale help a Chirp station outside the home network?

It runs a self-hosted Headscale control server so the station can reach the Chirp server privately.

Do I have to create the Headscale key myself?

No, it creates its own reusable key on first start and hands that key to the Chirp container.

Do I need Chirp-Headscale for iPhone push notifications?

No, self-hosted Chirp servers can request a push relay token so the iPhone app gets notifications.

Answers sourced from github.com

Community

No community discussions collected yet.