FAQ

Short answers about Fiber Studio, local nodes, channels, and first-launch warnings.

  • What is Fiber Studio?

    A desktop app for Fiber Network payments on Nervos CKB. It runs the official Fiber Network Node (fnn) on your computer and gives you a UI for setup, channels, and payments — without living in a terminal.

  • Is this a hosted wallet?

    No. Fiber Studio is local-first. Your CKB key stays on disk, your wallet password is stored in the OS keychain, and fnn runs on your machine. There is no Fiber Studio account and no hosted custody.

  • Can I use mainnet?

    Not yet. The setup wizard supports Testnet only. Mainnet may appear in the UI but is not available for setup today. Both sides of a payment must be on the same network (testnet).

  • Which platforms are supported?

    macOS (Apple Silicon and Intel), Windows 64-bit, and Linux (x64 and ARM64). Grab the installer for your machine on the Download page.

  • macOS says it can’t verify Fiber Studio. Is that safe?

    Yes for GitHub builds today. Releases are not Apple-notarized yet, so Gatekeeper may show “Fiber Studio” Not Opened. Do not click Move to Bin. Use System Settings → Privacy & Security → Open Anyway, or right-click the app in Finder → Open. Full steps are on Download.

    On Windows, SmartScreen can show a similar warning — choose More info → Run anyway.

  • What’s the difference between a peer and a channel?

    A peer connection is a P2P link on Network. A channel is the off-chain CKB lane you open on Channels. You need a connected peer and a channel in state Ready before you can send or receive. Connecting alone is not enough.

    Bootnodes under discovery help you find the network; you cannot open payment channels with them.

  • How much CKB do I need to open a channel?

    Capacity is at least 1,000 CKB. For a 1,000 CKB open, plan on about 1,109 CKB available on-chain (capacity + reserve + fee buffer). Fund the on-chain wallet shown on Channels before you open.

  • Why can’t I send or receive yet?

    Check these in order:

    • Top bar shows fnn running
    • Your saved peer on Network is Connected
    • A channel on Channels shows State: Ready
    • Sender has enough in-channel balance for the amount plus fees

    Walk through the full path on Get started.

  • Can two people pay if they’re not on the same Wi‑Fi?

    Yes. On the same LAN you can open a direct channel with each other. Far apart on normal home internet, the usual path is multi-hop: each person opens a channel with the same public hub (for example official testnet node1/node2), then payments route through that hub.

    Direct over the internet needs a dialable multiaddr (often port forwarding on 8228). Pubkey alone is usually not enough for a fresh home node.

  • Which release files should I download?

    Only the installer for your OS: .dmg, -setup.exe, .msi, .AppImage, .deb, or .rpm. Ignore .sig files, latest.json, and *.app.tar.gz — those are for in-app updates, not manual install.

  • How do updates work?

    After install, Fiber Studio can check for updates on launch and from Settings → Updates. In-app updates use a separate Tauri signing key — that is not the same as Apple or Windows code signing for the first download.

  • Where can I get help?

    Start with Get started and Download. For bugs or questions, open an issue on GitHub. Protocol details live in the Fiber docs.

Ready to try it?

Install Fiber Studio, start your local node, open a channel, then send or receive on testnet.