Icon of Fedimint Lightning Gateway app on Umbrel App Store

Fedimint Lightning Gateway

Lightning routing for Fedimints

Fedimint Developers

Open App Store on your umbrelOS device to install this app
Screenshot 1 of Fedimint Lightning Gateway app on Umbrel App Store
Screenshot 2 of Fedimint Lightning Gateway app on Umbrel App Store
Screenshot 3 of Fedimint Lightning Gateway app on Umbrel App Store
About this app

The Fedimint Lightning Gateway is an ecash wallet that connects Fedimint users to the broader Lightning Network. Operators can earn fees by providing outbound and inbound Lightning liquidity via their existing LND node.

Key Characteristics

  • Trust Model: Just like a Lightning node, a Lightning Gateway is not a custodian of the payments it is routing. Lightning Gateways should trust the federations they provide liquidity services to, but users do not need to trust the Lightning Gateway.

  • Multi-federation support: A single gateway can service multiple Fedimints simultaneously and swap ecash when payments occur between federations, bypassing the Lightning Network altogether.

  • Liquidity Management: Also like a Lightning node, gateways must maintain ecash balances in each federation to facilitate incoming payments, similar to inbound liquidity in Lightning.

Operating a Lightning Gateway

  1. Installing a Lightning Gateway is easy, just one click and it connects to your already provisioned LND node!

  2. Make sure your LND node has sufficient connectivity to the broader Lightning Network, ideally with balanced outbound and inbound liquidity.

  3. Operators must then connect to a federation using the federation's invite code.

  4. After connected, operators must pegin some ecash to the federation so that there is inbound liquidity.

  5. After the operator has obtained the ecash, the connection URL of the Lightning Gateway can be provided to the guardians. The guardians will then advertise that this Lightning Gateway is providing Lightning services to the federation.

  6. All set! The Fedimint can now send and receive payments over the Lightning Network.

What's new
Version v0.11.1last week

⚠️ Gateway first-boot behavior has changed: a mnemonic setup/recovery screen is now presented instead of auto-generating credentials. If automating setup, use the skip_setup flag.

Highlights in this release:

  • Gateway recovery and mnemonic management — create or restore your gateway from a mnemonic on first boot, and export/import federation invite codes for recovery
  • Guardian discovery via Pkarr — guardians now publish their identity and API addresses to the decentralized Pkarr DNS system for peer discovery without centralized coordination
  • Gateway UI overhaul — BOLT12 send/receive, one-click channel opens to existing peers, balance display in sats/BTC, payment filtering, peer and notes tabs, and a modernized Material-style design
  • Drastically lower memory usage — fixed a backtrace caching issue that reduced gatewayd memory from ~1.6GB to under 200MB, with tuned RocksDB defaults for constrained environments
  • Comprehensive observability — Prometheus metrics for networking, iroh connections, HTLC handling, Bitcoin RPC calls, and gateway-to-LN-node latency
  • Parallelized HTLC handling for better payment throughput
  • Liquidity Manager role with restricted permissions
  • Export/import federation invite codes for easier recovery
  • DB migration fix included in this patch release

Full release notes can be found at https://github.com/fedimint/fedimint/releases

Information