twinbird
Manage multiple NetBird instances on a single machine with isolated configs, daemon sockets, and WireGuard interfaces.
Install
uv tool install twinbird
or
pip install twinbird
Usage
# Start a named instance
twinbird up office --management-url https://mgmt.example.com --setup-key YOUR_KEY
# Check status
twinbird status office
# List all instances
twinbird list
# Stop an instance
twinbird down office
Environment Variables
Instead of passing flags every time:
export TWINBIRD_MANAGEMENT_URL=https://mgmt.example.com
export TWINBIRD_SETUP_KEY=YOUR_KEY
twinbird up office
| Variable | Purpose |
|---|---|
TWINBIRD_MANAGEMENT_URL |
Default management URL |
TWINBIRD_SETUP_KEY |
Default setup key |
TWINBIRD_NETBIRD_BIN |
Path to netbird binary (default: netbird on PATH) |
TWINBIRD_CONFIG_DIR |
Override root config directory |
How It Works
Each named instance gets:
- Its own config directory (
~/.config/twinbird/<name>/on Linux,%APPDATA%/twinbird/<name>/on Windows) - A unique daemon socket address (Unix socket on Linux/macOS, TCP port on Windows)
- A unique WireGuard interface name (
wt<N>on Linux,utun<N>on macOS)
Twinbird starts a separate netbird service run daemon per instance, then connects with netbird up — all fully isolated from the primary NetBird installation.
Requirements
- NetBird installed and on PATH
- Python 3.10+
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for twinbird 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| twinbird-0.1.4.tar.gz | 16.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| twinbird-0.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 29.2 kB
Release files / twinbird-0.1.4.tar.gz
| Download URL | twinbird-0.1.4.tar.gz |
|---|---|
| Size | 16.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d3162b49cf96b83d86375a9f75046cc669dd8435e77907b28c7e8c82cea5e3ca
|
|
BLAKE2b-256 checksum How to use checksums |
9bfcff5ce4a41ed0b01fa66e2888e88f2317fd8edc0b6116508b3a8a012cc976
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 8, 2026.
Transparency logRelease files / twinbird-0.1.4-py3-none-any.whl
| Download URL | twinbird-0.1.4-py3-none-any.whl |
|---|---|
| Size | 12.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed3ce9fecf8004c9f898802468a11dff981db957ee331519949a21735fbf654b
|
|
BLAKE2b-256 checksum How to use checksums |
14d3bd127758e31a789cddfa0595cc1735b3229b216869644ed5dd3985be7283
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 8, 2026.
Transparency log
