netbirdio/netbird
Documented errors, page 4 of 8. Back to netbirdio/netbird
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| client already started | error_code | warning | proxy, session-token, ed25519, authentication |
| decode v6 overlay address | exception | error | go, netbird, ipv6, encoding, network-map |
| Error marshaling sync response | http | error | |
| failed to insert established rule | exception | error | network, linux, iptables, conntrack, firewall |
| invalid payload: insufficient length | validation | error | relay, auth, hmac, token, payload |
| target port is required for L4 services | validation | error | netbird, reverse-proxy, validation, l4, port, targets, go |
| the management server | exception | error | sso, management, version-mismatch, grpc, upgrade |
| OIDC requires TLS — use port 443 | http | error | |
| peer already registered | exception | warning | signal, grpc, reconnect, peer-registry, sentinel-error |
| reset router | exception | warning | iptables, firewall, routing, cleanup, netbird, go |
| delete forward rule | console | error | |
| src faker raw conn | exception | warning | go, netbird, udp-proxy, raw-socket, teardown, race |
| timeout when waiting for interface | exception | error | go, netbird, interface, teardown, timeout |
| xembed: X error (ignored) | console | info | x11, xlib, system-tray, linux, c |
| delete IP from ipset | exception | error | go, linux, ipset, netlink, firewall, idempotency, netbird |
| init log | console | error | go, cli, logging, configuration |
| invalid duration format | validation | warning | cli, validation, duration, parsing, time |
| path is not supported for L4 services | validation | error | netbird, reverse-proxy, validation, l4, path, targets, go |
| remove windows v6 firewall rule | exception | warning | windows, firewall, netsh, ipv6, cleanup |
| add NAT rule | exception | error | iptables, ipv6, firewall, nat, netbird, go |
| no keys found in bundle | exception | error | go, netbird, security, parsing, update, keys |
| write public key file | console | error | go, cli, filesystem, permissions, signing |
| enable forwarding | exception | error | sysctl, ip-forwarding, permissions, containers, linux |
| failed to parse private root key | exception | error | go, crypto, ed25519, pem, release-signing, secrets |
| invalid port forward specification | validation | error | go, ssh, port-forwarding, validation, cli |
| private services require at least one access group | validation | error | go, netbird, management, reverse-proxy, access-control, validation |
| switch profile on daemon | console | error | profile, daemon, grpc, cli, netbird |
| unmarshaling response failed with error | exception | error | |
| converting fd to file failed | exception | error | go, netbird, raw-socket, unreachable-invariant, linux |
| delete ip from ipset | exception | error | go, linux, ipset, netlink, firewall, idempotency, netbird |
| failed to rename profile | exception | error | android, go, profile, validation, rename |
| authentication service unavailable | http | error | |
| failed to decode PEM data | exception | error | go, netbird, security, pem, parsing, keys |
| split host port | validation | error | network, validation, listen, embed |
| identity provider issuer must be a valid URL | validation | error | management, identity-provider, oidc, url, validation |
| load config | exception | error | android, debug, configuration, file-io |
| init ip6tables | exception | error | go, linux, ip6tables, ipv6, environment, container, netbird |
| session_idle_timeout must be positive for L4 services | validation | error | netbird, reverse-proxy, validation, l4, timeout, configuration, go |
| unsupported identity provider type | validation | error | management, identity-provider, oidc, validation, version-compat |
| identity provider issuer is required | validation | error | management, identity-provider, oidc, validation |
| proxy_protocol is not supported for UDP services | validation | error | netbird, reverse-proxy, validation, udp, proxy-protocol, l4, go |
| add route filtering | exception | error | iptables, ipv6, firewall, routing, netbird, go |
| invalid IPv6 port forward specification | validation | error | go, ssh, port-forwarding, ipv6, validation |
| invalid token data: insufficient length | validation | error | relay, auth, hmac, token, corruption |
| add jump to MSS clamp chain | console | error | network, linux, iptables, mss-clamping, mangle |
| invalid IPv6 port forward specification | validation | error | go, ssh, port-forwarding, ipv6, validation |
| invalid MTU | validation | error | config, mtu, validation, embed |
| invalid remote address | validation | error | go, ssh, port-forwarding, validation, cli |
| startup check: signal not connected | console | error | cli, signal, startup, network, netbird |
| add outbound masquerade rule | exception | error | network, linux, iptables, nat, masquerade |
| invalid port | validation | error | go, ssh, validation, port, cli |
| invalid record name format | validation | error | dns, zones, validation, punycode |
| sign artifact | exception | error | go, crypto, ed25519, release-signing, validation |
| add return masquerade rule | exception | error | network, linux, iptables, nat, masquerade |
| failed to request access token with error | exception | error | |
| invalid message length | validation | error | relay, protocol, parsing, framing |
| peer has no stored SSH host key | console | warning | go, netbird, ssh, host-key, trust-on-first-use |
| setenv | exception | error | environment, runtime, embed, rare |
| failed to read private root key file | exception | error | go, cli, filesystem, release-signing, secrets |
| flush delete output DNAT rule | exception | error | nftables, netlink, cleanup, linux |
| destroy set | exception | error | iptables, ipset, cleanup, linux, netbird |
| receive expose event | exception | error | grpc, server-stream, expose, context-canceled, netbird-cli |
| apply network -d | console | error | network, linux, ipset, iptables, routing |
| delete snat rule | exception | error | nftables, netlink, snat, masquerade |
| get config file | console | error | cli, foreground, config, filesystem, netbird |
| switch profile failed | console | error | profile, grpc, not-found, cli, netbird |
| waiting sso login failed with | console | error | grpc, sso, login, daemon, netbird |
| an earlier read of the policy table has not returned | console | error | proxy, grpc, session-validation, availability, oidc |
| connect to daemon | exception | error | grpc, daemon, connection, ipc, netbird-cli |
| error creating tun device | exception | critical | windows, wintun, adapter, driver, permissions |
| failed to select networks | console | error | grpc, networks, validation, cli |
| remove v4 NAT rule | exception | warning | iptables, firewall, nat, cleanup, netbird, go |
| domain is required for TLS services (used for SNI matching) | validation | error | netbird, reverse-proxy, validation, tls, sni, domain, go |
| resource not part of network | validation | error | networks, resources, management-api, validation |
| is not a valid input for . it should be an IP string or a… | validation | warning | go, netbird, cli, validation, nat, network-interface, external-ip-map |
| startup check: management not connected | console | error | cli, management, startup, network, netbird |
| failed to read signature file | exception | error | go, cli, file-io, signature, revocation |
| only integration service user can delete this user | validation | error | management, users, api, permissions, integration |
| invalid DNS address | validation | error | android, dns, validation, ip-address |
| ipc get | exception | warning | wireguard-go, stats, cache, uapi, lifecycle |
| one of SetupKey, JWTToken, or PrivateKey must be provided | validation | error | go, netbird, embedded, validation, authentication, setup-key |
| read of the policy table timed out | console | info | proxy, debug, http, observability |
| at least one --artifact-pub-key-file must be provided | validation | warning | cli, signing, validation, go, cobra |
| create acl manager | exception | error | go, linux, iptables, firewall, startup, netbird |
| check chain | console | warning | iptables, cleanup, linux, netbird, diagnostics |
| group not found | exception | warning | rest, groups, api, not-found |
| invalid session token | http | error | |
| no relay transport available | exception | error | relay, transport, dialer, configuration |
| add inbound DNAT | exception | error | |
| custom_headers is not supported for L4 services | validation | error | netbird, reverse-proxy, validation, l4, headers, options, go |
| peer registered again | exception | info | signal, grpc, stream-lifecycle, sentinel-error |
| service domain is required | validation | error | go, netbird, management, reverse-proxy, validation, http |
| add nat prerouting jump rule | exception | error | network, linux, iptables, nat, dnat |
| add output DNAT | exception | error | |
| add iptables input rule | exception | error | |
| no connection to management | exception | error | go, grpc, netbird, client, connectivity |
| add mangle prerouting jump rule | exception | error | network, linux, iptables, mangle, firewall |
| parse new name | exception | error | go, freebsd, ifconfig, parsing, rename |
| password must contain at least | validation | error | management, users, password, validation, security |
| add OUTPUT jump rule | exception | error |