Home

Flavor is an open-source desktop app, daemon and CLI for using several Tailscale and Headscale networks at the same time on Linux, macOS and Windows. Start with the project README for an overview.

Using Flavor

Guide	What it covers
Install, verify, upgrade and uninstall	Requirements, the release tarball, signature checks, Arch Linux packages, building from source, upgrading from Lattice, uninstalling
macOS	Installing on a Mac with Homebrew or the tarball, opening the unsigned build, the LaunchAgent, file locations, and what differs from Linux
Windows	Installing on Windows with the installer or the zip, the unsigned-installer warning, file locations, and what differs from Linux
Getting started	Adding a Tailscale account or Headscale server, signing in, finding devices, connecting to a service
Names, decisions and connections	How Flavor tells overlapping addresses apart, Flavor names, the decision rules, Connection Inspector, Conflict Center, preferences, port forwarding, SOCKS5 and workspaces
flavorctl reference	Every command and option, with example output
System-wide names (experimental)	The optional root helper: what it changes, how it is authorized and confined, and how to turn it on and off
Troubleshooting	Logs, diagnostics and fixes for common problems

How it works

Page	What it covers
Security model	Privileges, local access control, credentials, logs, the webview, the helper and release integrity
Architecture	Components, IPC, UI synchronization, data locations and repository layout

Project

• Contributing: development setup, tests and pull requests
• Security policy: how to report a vulnerability
• Code of conduct