Where Does NetBird Store Config?
NetBird WireGuard config and state folders on Windows, macOS and Linux.
Last updated
NetBird keeps device identity, WireGuard keys and management state in per-OS system folders, separate from the UI preferences. Copying keys between machines duplicates identity, so treat backups as restore-only.
Reinstall with the dashboard, never by cloning state folders. Duplicate peer identities cause routing fights nobody can debug from logs alone.
Where NetBird stores this, by platform
C:\ProgramData\NetBird
System-wide state with keys and engine config. The UI agama stores prefs separately per user. Stop the service before touching these files and prefer dashboard re-enrollment over copies.
/etc/netbird
Daemon config and keys for mac installs. UI prefs live per user in Application Support. Re-enroll from the dashboard instead of cloning.
/etc/netbird
System config.json plus state files for the daemon. User CLI sessions reference this tree. Back up for disaster recovery, restore to the same hostname only.
Frequently asked questions
Can I copy NetBird config to a second PC?
No, identity keys in the folders above are per device. Install fresh and enroll each machine separately.
Where are NetBird logs?
Beside state in system logs per OS, not in the folders above. Check service journals when tunnels flap.
Notice an outdated path? Let us know.