package daemon

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc AddProfile (AddProfileRequest, AddProfileResponse)

  daemon.proto:75

  message AddProfileRequest

  daemon.proto:597

  • string username = 1

  • string profileName = 2

  message AddProfileResponse

  daemon.proto:602

  (message has no fields)

• rpc CleanState (CleanStateRequest, CleanStateResponse)

  daemon.proto:57

  Clean specific state or all states

  message CleanStateRequest

  daemon.proto:441

  CleanStateRequest for cleaning states

  • string state_name = 1

  • bool all = 2

  message CleanStateResponse

  daemon.proto:447

  CleanStateResponse contains the result of the clean operation

  • int32 cleaned_states = 1

• rpc DebugBundle (DebugBundleRequest, DebugBundleResponse)

  daemon.proto:45

  DebugBundle creates a debug bundle

  message DebugBundleRequest

  daemon.proto:388

  DebugBundler

  • bool anonymize = 1

  • string status = 2

  • bool systemInfo = 3

  • string uploadURL = 4

  • uint32 logFileCount = 5

  message DebugBundleResponse

  daemon.proto:396

  • string path = 1

  • string uploadedKey = 2

  • string uploadFailureReason = 3

• rpc DeleteState (DeleteStateRequest, DeleteStateResponse)

  daemon.proto:60

  Delete specific state or all states

  message DeleteStateRequest

  daemon.proto:452

  DeleteStateRequest for deleting states

  • string state_name = 1

  • bool all = 2

  message DeleteStateResponse

  daemon.proto:458

  DeleteStateResponse contains the result of the delete operation

  • int32 deleted_states = 1

• rpc DeselectNetworks (SelectNetworksRequest, SelectNetworksResponse)

  daemon.proto:40

  Deselect specific routes

• rpc Down (DownRequest, DownResponse)

  daemon.proto:28

  Down engine work in the daemon.

  message DownRequest

  daemon.proto:201

  (message has no fields)

  message DownResponse

  daemon.proto:203

  (message has no fields)

• rpc ForwardingRules (EmptyRequest, ForwardingRulesResponse)

  daemon.proto:42

  message EmptyRequest

  daemon.proto:11

  (message has no fields)

  message ForwardingRulesResponse

  daemon.proto:382

  • repeated ForwardingRule rules = 1

• rpc GetActiveProfile (GetActiveProfileRequest, GetActiveProfileResponse)

  daemon.proto:81

  message GetActiveProfileRequest

  daemon.proto:624

  (message has no fields)

  message GetActiveProfileResponse

  daemon.proto:626

  • string profileName = 1

  • string username = 2

• rpc GetConfig (GetConfigRequest, GetConfigResponse)

  daemon.proto:31

  GetConfig of the daemon.

  message GetConfigRequest

  daemon.proto:205

  • string profileName = 1

  • string username = 2

  message GetConfigResponse

  daemon.proto:210

  • string managementUrl = 1

    managementUrl settings value.

  • string configFile = 2

    configFile settings value.

  • string logFile = 3

    logFile settings value.

  • string preSharedKey = 4

    preSharedKey settings value.

  • string adminURL = 5

    adminURL settings value.

  • string interfaceName = 6

  • int64 wireguardPort = 7

  • int64 mtu = 8

  • bool disableAutoConnect = 9

  • bool serverSSHAllowed = 10

  • bool rosenpassEnabled = 11

  • bool rosenpassPermissive = 12

  • bool disable_notifications = 13

  • bool lazyConnectionEnabled = 14

  • bool blockInbound = 15

  • bool networkMonitor = 16

  • bool disable_dns = 17

  • bool disable_client_routes = 18

  • bool disable_server_routes = 19

  • bool block_lan_access = 20

• rpc GetEvents (GetEventsRequest, GetEventsResponse)

  daemon.proto:69

  message GetEventsRequest

  daemon.proto:529

  (message has no fields)

  message GetEventsResponse

  daemon.proto:531

  • repeated SystemEvent events = 1

• rpc GetFeatures (GetFeaturesRequest, GetFeaturesResponse)

  daemon.proto:86

  message GetFeaturesRequest

  daemon.proto:638

  (message has no fields)

  message GetFeaturesResponse

  daemon.proto:640

  • bool disable_profiles = 1

  • bool disable_update_settings = 2

• rpc GetLogLevel (GetLogLevelRequest, GetLogLevelResponse)

  daemon.proto:48

  GetLogLevel gets the log level of the daemon

  message GetLogLevelRequest

  daemon.proto:413

  (message has no fields)

  message GetLogLevelResponse

  daemon.proto:416

  • LogLevel level = 1

• rpc ListNetworks (ListNetworksRequest, ListNetworksResponse)

  daemon.proto:34

  List available networks

  message ListNetworksRequest

  daemon.proto:333

  Networks

  (message has no fields)

  message ListNetworksResponse

  daemon.proto:336

  • repeated Network routes = 1

• rpc ListProfiles (ListProfilesRequest, ListProfilesResponse)

  daemon.proto:79

  message ListProfilesRequest

  daemon.proto:611

  • string username = 1

  message ListProfilesResponse

  daemon.proto:615

  • repeated Profile profiles = 1

• rpc ListStates (ListStatesRequest, ListStatesResponse)

  daemon.proto:54

  List all states

  message ListStatesRequest

  daemon.proto:433

  ListStatesRequest is empty as it requires no parameters

  (message has no fields)

  message ListStatesResponse

  daemon.proto:436

  ListStatesResponse contains a list of states

  • repeated State states = 1

• rpc Login (LoginRequest, LoginResponse)

  daemon.proto:15

  Login uses setup key to prepare configuration for the daemon.

  message LoginRequest

  daemon.proto:90

  • string setupKey = 1

    setupKey netbird setup key.

  • string preSharedKey = 2

    This is the old PreSharedKey field which will be deprecated in favor of optionalPreSharedKey field that is defined as optional to allow clearing of preshared key while being able to persist in the config file.

  • string managementUrl = 3

    managementUrl to authenticate.

  • string adminURL = 4

    adminUrl to manage keys.

  • repeated string natExternalIPs = 5

    natExternalIPs map list of external IPs

  • bool cleanNATExternalIPs = 6

    cleanNATExternalIPs clean map list of external IPs. This is needed because the generated code omits initialized empty slices due to omitempty tags

  • bytes customDNSAddress = 7

  • bool isUnixDesktopClient = 8

  • string hostname = 9

  • optional bool rosenpassEnabled = 10

  • optional string interfaceName = 11

  • optional int64 wireguardPort = 12

  • optional string optionalPreSharedKey = 13

  • optional bool disableAutoConnect = 14

  • optional bool serverSSHAllowed = 15

  • optional bool rosenpassPermissive = 16

  • repeated string extraIFaceBlacklist = 17

  • optional bool networkMonitor = 18

  • optional google.protobuf.Duration dnsRouteInterval = 19

  • optional bool disable_client_routes = 20

  • optional bool disable_server_routes = 21

  • optional bool disable_dns = 22

  • optional bool disable_firewall = 23

  • optional bool block_lan_access = 24

  • optional bool disable_notifications = 25

  • repeated string dns_labels = 26

  • bool cleanDNSLabels = 27

    cleanDNSLabels clean map list of DNS labels. This is needed because the generated code omits initialized empty slices due to omitempty tags

  • optional bool lazyConnectionEnabled = 28

  • optional bool block_inbound = 29

  • optional string profileName = 30

  • optional string username = 31

  • optional int64 mtu = 32

  message LoginResponse

  daemon.proto:163

  • bool needsSSOLogin = 1

  • string userCode = 2

  • string verificationURI = 3

  • string verificationURIComplete = 4

• rpc Logout (LogoutRequest, LogoutResponse)

  daemon.proto:84

  Logout disconnects from the network and deletes the peer from the management server

  message LogoutRequest

  daemon.proto:631

  • optional string profileName = 1

  • optional string username = 2

  message LogoutResponse

  daemon.proto:636

  (message has no fields)

• rpc RemoveProfile (RemoveProfileRequest, RemoveProfileResponse)

  daemon.proto:77

  message RemoveProfileRequest

  daemon.proto:604

  • string username = 1

  • string profileName = 2

  message RemoveProfileResponse

  daemon.proto:609

  (message has no fields)

• rpc SelectNetworks (SelectNetworksRequest, SelectNetworksResponse)

  daemon.proto:37

  Select specific routes

• rpc SetConfig (SetConfigRequest, SetConfigResponse)

  daemon.proto:73

  message SetConfigRequest

  daemon.proto:542

  • string username = 1

  • string profileName = 2

  • string managementUrl = 3

    managementUrl to authenticate.

  • string adminURL = 4

    adminUrl to manage keys.

  • optional bool rosenpassEnabled = 5

  • optional string interfaceName = 6

  • optional int64 wireguardPort = 7

  • optional string optionalPreSharedKey = 8

  • optional bool disableAutoConnect = 9

  • optional bool serverSSHAllowed = 10

  • optional bool rosenpassPermissive = 11

  • optional bool networkMonitor = 12

  • optional bool disable_client_routes = 13

  • optional bool disable_server_routes = 14

  • optional bool disable_dns = 15

  • optional bool disable_firewall = 16

  • optional bool block_lan_access = 17

  • optional bool disable_notifications = 18

  • optional bool lazyConnectionEnabled = 19

  • optional bool block_inbound = 20

  • repeated string natExternalIPs = 21

  • bool cleanNATExternalIPs = 22

  • bytes customDNSAddress = 23

  • repeated string extraIFaceBlacklist = 24

  • repeated string dns_labels = 25

  • bool cleanDNSLabels = 26

    cleanDNSLabels clean map list of DNS labels.

  • optional google.protobuf.Duration dnsRouteInterval = 27

  • optional int64 mtu = 28

  message SetConfigResponse

  daemon.proto:595

  (message has no fields)

• rpc SetLogLevel (SetLogLevelRequest, SetLogLevelResponse)

  daemon.proto:51

  SetLogLevel sets the log level of the daemon

  message SetLogLevelRequest

  daemon.proto:420

  • LogLevel level = 1

  message SetLogLevelResponse

  daemon.proto:424

  (message has no fields)

• rpc SetSyncResponsePersistence (SetSyncResponsePersistenceRequest, SetSyncResponsePersistenceResponse)

  daemon.proto:63

  SetSyncResponsePersistence enables or disables sync response persistence

  message SetSyncResponsePersistenceRequest

  daemon.proto:463

  • bool enabled = 1

  message SetSyncResponsePersistenceResponse

  daemon.proto:467

  (message has no fields)

• rpc Status (StatusRequest, StatusResponse)

  daemon.proto:25

  Status of the service.

  message StatusRequest

  daemon.proto:186

  • bool getFullPeerStatus = 1

  • bool shouldRunProbes = 2

  • optional bool waitForReady = 3

    the UI do not using this yet, but CLIs could use it to wait until the status is ready

  message StatusResponse

  daemon.proto:193

  • string status = 1

    status of the server.

  • optional FullStatus fullStatus = 2

  • string daemonVersion = 3

    NetBird daemon version

• rpc SubscribeEvents (SubscribeRequest, stream SystemEvent)

  daemon.proto:67

  message SubscribeRequest

  daemon.proto:502

  (message has no fields)

• rpc SwitchProfile (SwitchProfileRequest, SwitchProfileResponse)

  daemon.proto:71

  message SwitchProfileRequest

  daemon.proto:535

  • optional string profileName = 1

  • optional string username = 2

  message SwitchProfileResponse

  daemon.proto:540

  (message has no fields)

• rpc TracePacket (TracePacketRequest, TracePacketResponse)

  daemon.proto:65

  message TracePacketRequest

  daemon.proto:478

  • string source_ip = 1

  • string destination_ip = 2

  • string protocol = 3

  • uint32 source_port = 4

  • uint32 destination_port = 5

  • string direction = 6

  • optional TCPFlags tcp_flags = 7

  • optional uint32 icmp_type = 8

  • optional uint32 icmp_code = 9

  message TracePacketResponse

  daemon.proto:497

  • repeated TraceStage stages = 1

  • bool final_disposition = 2

• rpc Up (UpRequest, UpResponse)

  daemon.proto:22

  Up starts engine work in the daemon.

  message UpRequest

  daemon.proto:179

  • optional string profileName = 1

  • optional string username = 2

  message UpResponse

  daemon.proto:184

  (message has no fields)

• rpc WaitSSOLogin (WaitSSOLoginRequest, WaitSSOLoginResponse)

  daemon.proto:19

  WaitSSOLogin uses the userCode to validate the TokenInfo and waits for the user to continue with the login on a browser

  message WaitSSOLoginRequest

  daemon.proto:170

  • string userCode = 1

  • string hostname = 2

  message WaitSSOLoginResponse

  daemon.proto:175

  • string email = 1

Used in: ForwardingRulesResponse

• string protocol = 1

• optional PortInfo destinationPort = 2

• string translatedAddress = 3

• string translatedHostname = 4

• optional PortInfo translatedPort = 5

FullStatus contains the full state held by the Status instance

Used in: StatusResponse

• optional ManagementState managementState = 1

• optional SignalState signalState = 2

• optional LocalPeerState localPeerState = 3

• repeated PeerState peers = 4

• repeated RelayState relays = 5

• repeated NSGroupState dns_servers = 6

• int32 NumberOfForwardingRules = 8

• repeated SystemEvent events = 7

• bool lazyConnectionEnabled = 9

Used in: Network

• repeated string ips = 1

LocalPeerState contains the latest state of the local peer

Used in: FullStatus

• string IP = 1

• string pubKey = 2

• bool kernelInterface = 3

• string fqdn = 4

• bool rosenpassEnabled = 5

• bool rosenpassPermissive = 6

• repeated string networks = 7

Used in: GetLogLevelResponse, SetLogLevelRequest

• UNKNOWN = 0

• PANIC = 1

• FATAL = 2

• ERROR = 3

• WARN = 4

• INFO = 5

• DEBUG = 6

• TRACE = 7

ManagementState contains the latest state of a management connection

Used in: FullStatus

• string URL = 1

• bool connected = 2

• string error = 3

Used in: FullStatus

• repeated string servers = 1

• repeated string domains = 2

• bool enabled = 3

• string error = 4

Used in: ListNetworksResponse

• string ID = 1

• string range = 2

• bool selected = 3

• repeated string domains = 4

• map<string, IPList> resolvedIPs = 5

PeerState contains the latest state of a peer

Used in: FullStatus

• string IP = 1

• string pubKey = 2

• string connStatus = 3

• optional google.protobuf.Timestamp connStatusUpdate = 4

• bool relayed = 5

• string localIceCandidateType = 7

• string remoteIceCandidateType = 8

• string fqdn = 9

• string localIceCandidateEndpoint = 10

• string remoteIceCandidateEndpoint = 11

• optional google.protobuf.Timestamp lastWireguardHandshake = 12

• int64 bytesRx = 13

• int64 bytesTx = 14

• bool rosenpassEnabled = 15

• repeated string networks = 16

• optional google.protobuf.Duration latency = 17

• string relayAddress = 18

ForwardingRules

Used in: ForwardingRule

• oneof portSelection

  • uint32 port = 1

  • PortInfo.Range range = 2

Used in: PortInfo

• uint32 start = 1

• uint32 end = 2

Used in: ListProfilesResponse

• string name = 1

• bool is_active = 2

RelayState contains the latest state of the relay

Used in: FullStatus

• string URI = 1

• bool available = 2

• string error = 3

Used as request type in: DaemonService.DeselectNetworks, DaemonService.SelectNetworks

• repeated string networkIDs = 1

• bool append = 2

• bool all = 3

Used as response type in: DaemonService.DeselectNetworks, DaemonService.SelectNetworks

(message has no fields)

SignalState contains the latest state of a signal connection

Used in: FullStatus

• string URL = 1

• bool connected = 2

• string error = 3

State represents a daemon state entry

Used in: ListStatesResponse

• string name = 1

Used as response type in: DaemonService.SubscribeEvents

Used as field type in: FullStatus, GetEventsResponse

• string id = 1

• SystemEvent.Severity severity = 2

• SystemEvent.Category category = 3

• string message = 4

• string userMessage = 5

• optional google.protobuf.Timestamp timestamp = 6

• map<string, string> metadata = 7

Used in: SystemEvent

• NETWORK = 0

• DNS = 1

• AUTHENTICATION = 2

• CONNECTIVITY = 3

• SYSTEM = 4

Used in: SystemEvent

• INFO = 0

• WARNING = 1

• ERROR = 2

• CRITICAL = 3

Used in: TracePacketRequest

• bool syn = 1

• bool ack = 2

• bool fin = 3

• bool rst = 4

• bool psh = 5

• bool urg = 6

Used in: TracePacketResponse

• string name = 1

• string message = 2

• bool allowed = 3

• optional string forwarding_details = 4