Skip to main content

Setup Guide

Connect Lokihub to your node and start managing your Lightning liquidity in minutes.

Before you start​

To use Lokihub, you'll need:

tip

If you're running tWallet v1 on the same computer, Lokihub will find it for you automatically. Use the Automated Connection option!

First Launch​

  1. Open Lokihub.
  2. Follow the setup wizard to get started.

Step-by-Step Setup​

1. Create a Password​

Set a strong password to protect your data. This password encrypts your connection details and app settings.

Important: We cannot recover this password for you. Please write it down and keep it safe.

2. Choose Your Services​

Lokihub uses specific services to interact with the network:

  • Nostr Relay: Connects your node to external apps.
  • Block Explorer: Shows you transaction details.
  • Optional: You can also add Liquidity (LSP) or Swap services later.

3. Connect to tWallet​

Lokihub connects to the Lightning node built into tWallet v1.

Local Node Setup

Option A: Automated Connection (Recommended)​

If tWallet is running on the same machine:

  1. Choose "Local Node" during the setup wizard.
  2. Lokihub will automatically link with your tWallet credentials.
  3. You're ready to go!

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 window. This displays 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​

1. Secure Your Sovereignty (Required)​

Before you open your first channel, you must establish a reliable recovery plan. Unlike traditional on-chain funds, Lightning liquidity needs active protection.

CHANNEL BACKUPS ARE NOT AUTOMATIC

Your 24-word seed phrase ONLY recovers funds on the blockchain. To protect your channel liquidity from system failures, you MUST maintain a copy of your channel.backup file.

  1. Locate: On Linux, this is typically in ~/.flnd/data/chain/flokicoin/mainnet/channel.backup.
  2. Backup: Copy this file to a separate device (USB, Cloud, etc.) every time you open or close a channel.
  3. Learn More: Read the full Lightning Backup Guide.

2. Further Reading​

Once connected, you can: