Skip to main content

Setup Guide

Get Lokihub connected to your Lightning node in a few simple steps.

Prerequisites​

Before starting, make sure you have:

  • Downloaded and installed Lokihub (Downloads)
  • tWallet running (which powers FLND, your Lightning node)
tip

If you're running tWallet locally, Lokihub will auto-detect it. No manual configuration needed!

First Launch​

  1. Run Lokihub
  2. You'll see the first-time setup wizard

Setup Steps​

Step 1: Create Unlock Password​

Set a strong password to encrypt your local data. This password protects your connection credentials and app permissions.

Important: There is no password recovery. Write it down and store it securely.

Step 2: Choose Services​

Lokihub uses external services to power your node.

Core Services:

  • Nostr Relay — Routes NWC messages to connect apps.
  • Block Explorer — Looks up transactions and node stats.

Optional Services:

  • LSP — Buy inbound/outbound channel liquidity.
  • Swap Service — Swap between on-chain funds and Lightning balance.
  • Message Board — Connect to community chat widgets via Nostr URL.

Step 3: Connect to Your Node​

Lokihub connects to the FLND built into tWallet. You have two options:

Local Node Setup

Option A: Local Node with default configuration (Easy)​

If tWallet is running on the same machine:

  1. Select "Local Node"
  2. Lokihub will auto-detect the FLND connection
  3. Done!

Option B: Custom tWallet configuration (Advanced)​

If you're running tWallet on another machine (VPS, Raspberry Pi, etc.):

  1. Select "Advanced Mode"

  2. Enter connection details:

    • gRPC Address: IP and port (example: 127.0.0.1:10005)
    • Macaroon: Paste admin.macaroon hex content
    • TLS Certificate: Paste tls.cert hex content (Optional)

  3. Click "Connect"

How to find these credentials

In tWallet, press CTRL+N to open the Lightning configuration. This key combination opens a window displaying your gRPC Address, Macaroon Hex, and TLS Certificate Hex. Simply copy and paste them into Lokihub.

Troubleshooting​

Can't connect to local tWallet?

  • Make sure tWallet is running
  • Check that ports aren't blocked by firewall

Remote connection fails?

  • Verify the gRPC address is correct
  • Ensure your node is accessible from your network
  • Check that macaroon and TLS cert hex strings are correct

Need help?
Join the community on Discord in #lokihub

Next Steps​

Once connected, you can: