Skip to main content

gRPC API

Fungi CLI and Fungi App both control the local daemon through gRPC. Custom tools can use the same API.

Server Address​

By default, the daemon listens on:

127.0.0.1:5405

Print the active address:

fungi info rpc-address

If you edit the daemon config directly, restart the daemon afterwards.

Proto File​

The service definition lives in the Fungi repository:

fungi_daemon.proto

Release builds may also publish a copy with release assets.

Explore With grpcurl​

Start the daemon:

fungi daemon

List methods:

grpcurl -plaintext -proto fungi_daemon.proto 127.0.0.1:5405 list fungi_daemon.FungiDaemon

Call a simple method:

grpcurl -plaintext -proto fungi_daemon.proto 127.0.0.1:5405 fungi_daemon.FungiDaemon/Version

Current API Shape​

The user-facing API follows the same device and service model as the CLI:

  • device discovery and saved devices
  • trusted devices
  • local and remote services
  • service recipes
  • device service snapshots
  • service access listeners
  • relay configuration and connection diagnostics

Low-level protobuf field names may still use peer_id where the underlying libp2p identity is exposed.