Fungi Documentation

Fungi helps you build a private encrypted P2P device network, then run and consume capability-first services across that network.

Install Fungi from the one-line installer, GitHub Releases, or source build: Install Fungi.

Start Here First

• 3-Minute Quick Start: Build Your Private P2P Network: connect two of your own devices and verify the link with fungi ping.
• 2-Minute Quick Start: Run a Remote Sandbox App Locally: start a sandboxed app on one device and open it locally from another device.

Core Concepts

• Daemon architecture: fungi daemon runs networking, discovery, relay fallback, and service state.
• Multiple control clients: Fungi CLI, Fungi App, and any gRPC client all control the same daemon API.
• PeerID-based trust: inbound access is controlled by allowed peers.
• Capability-first services: publish container or WASI workloads according to explicit runtime and network policy.

What You Can Do Today

• Build a private device mesh for your own machines without depending on a public control plane.
• Run capability-first container and WASI services under explicit runtime policy.
• Control remote nodes from the CLI and open published web apps locally through access open.
• Check connection health with built-in tools for active links, streams, and latency.

Documentation Map

• 3-Minute Quick Start: Build Your Private P2P Network: the shortest newcomer path to connect two devices.
• 2-Minute Quick Start: Run a Remote Sandbox App Locally: the shortest newcomer path to run a remote app and open it locally.
• Install Fungi: quick install, releases, Windows entry point, source build, and Linux systemd --user notes.
• Fungi CLI Guide: detailed CLI setup flow for local init, trust, peer context, and service basics.
• Services And Runtimes: service manifests, runtime model, and publish/access flow.
• Runtime Examples: direct Docker and Wasmtime manifest downloads plus side-by-side runtime examples.
• Remote Service Control: control a remote node, manage its services, and open its web app locally.
• Connection Diagnostics: inspect active streams and continuously ping peers.
• gRPC Guide: integrate your own scripts/tools with daemon APIs.
• Self-hosted Relay: run your own relay infrastructure.
• Built-in WASI Support: run or serve WASI modules through Fungi CLI.
• Deprecated File Transfer: legacy FTP/WebDAV workflow kept only for compatibility.

Recommended Reading Paths

For CLI Users

1. 3-Minute Quick Start: Build Your Private P2P Network
2. 2-Minute Quick Start: Run a Remote Sandbox App Locally
3. Fungi CLI Guide
4. Services And Runtimes
5. Remote Service Control
6. Connection Diagnostics
7. Self-hosted Relay

For Integrators

1. gRPC Guide
2. Services And Runtimes
3. Remote Service Control
4. Fungi CLI Guide

For Experimental WASI Workloads

1. Fungi CLI Guide
2. Services And Runtimes
3. Runtime Examples
4. Built-in WASI Support