How to Connect Zeus Wallet to Your Umbrel Lightning Node

Running your own Lightning node on Umbrel is only half the equation. The other half is actually using it, which means having reliable mobile access to manage channels, send payments, and monitor your node from anywhere. Zeus remains the go-to solution for this, offering a self-custodial mobile interface that connects to your home node over Tor.

The connection process is straightforward once you understand the pieces involved. Here's how to set it up, what to watch for, and how to troubleshoot the common issues that trip people up.

Prerequisites Before You Start

Before attempting the connection, make sure your Umbrel setup meets these requirements:

• Bitcoin Core must be fully synced. If it's still catching up, your Lightning node won't function properly and connections will fail.
• Your Lightning Node app (either LND or Core Lightning) should be installed and running on Umbrel.
• Zeus should be installed on your mobile device from the App Store or Google Play.

The connection uses Tor by default, which means your node's location stays private and you can connect from anywhere without opening ports on your router. This adds some latency but significantly improves security.

Connecting Zeus to LND on Umbrel

Most Umbrel users run LND, and this remains the most stable connection method. The process uses REST over Tor:

1. Open the Lightning Node app on your Umbrel dashboard
2. Click the three-dot menu and select "Connect Wallet"
3. Choose "Zeus" from the wallet options, then select "REST (Tor)"
4. Umbrel will display a QR code along with text fields showing your Host, Port, and Macaroon

In Zeus, navigate to Settings > Add a new node. You have two options:

QR Code Method (Recommended): Tap the camera icon and scan the QR code from your Umbrel screen. Zeus will auto-populate all fields.

Manual Entry: If scanning doesn't work, copy each field individually. Select "LND (REST)" as the node interface, paste the Host URL (which will be a .onion address), the Port number, and the Macaroon string.

Save the configuration and Zeus will attempt to connect. The initial Tor connection can take 30 seconds to a minute, so be patient.

Connecting Zeus to Core Lightning on Umbrel

Umbrel now supports Core Lightning (CLN), and as of mid-2025, Zeus connection methods have improved significantly. For local network access, you can connect using:

• URL: `https://umbrel.local:2107`
• Authentication: Rune-based (generated in Core Lightning settings)

Tor support for Core Lightning connections was still being refined in 2025, so if you need remote access specifically, LND remains the more reliable choice. Some users have worked around this by installing the Alby Hub app on Umbrel and using the NWC (Nostr Wallet Connect) protocol for Zeus compatibility.

Troubleshooting Common Connection Issues

"Failed to connect LNC client to proxy server"

This error appeared frequently in early 2025 reports. The fix is usually simple: force-close Zeus completely and reopen it, or restart the Lightning Node app on Umbrel. If that doesn't work, try regenerating the connection credentials by going through the Connect Wallet flow again.

Connection times out repeatedly

Tor connections can be finicky. Check that:

• Your Umbrel is online and accessible via its local dashboard
• The Lightning Node app shows as running (green status)
• Your phone has a stable internet connection (Tor struggles on weak signals)

On-chain wallet addresses don't match

This catches people off guard. The on-chain wallet displayed in Zeus is separate from your Umbrel node's on-chain wallet. Zeus generates its own seed for on-chain funds. If you want to use your Umbrel's on-chain Bitcoin, send it through Lightning channels or transfer directly to the address shown in your Umbrel dashboard, not Zeus.

Managing Your Node from Zeus

Once connected, Zeus gives you substantial control over your Lightning node:

• Channel Management: Open and close channels, view channel balances, and monitor routing activity
• Payments: Send and receive Lightning payments using your node's liquidity
• Invoices: Generate invoices and track incoming payments
• Node Info: Monitor sync status, block height, and peer connections

Zeus also supports features like coin control for on-chain transactions, though remember these operate from Zeus's own wallet, not your Umbrel's on-chain funds.

For users who accept payments regularly, Zeus's point-of-sale mode and Lightning address features work well with a connected node, letting you receive funds directly to your self-custodial setup.

Security Considerations

The Tor connection provides strong privacy, hiding your node's IP address even from Zeus's developers. However, the macaroon you copy into Zeus grants significant permissions over your node. Treat it like a password:

• Don't share screenshots that show the macaroon string or QR code
• If you suspect your phone is compromised, regenerate credentials on Umbrel
• Consider using a read-only macaroon if you only need monitoring, not full control

What to Expect Going Forward

The Zeus and Umbrel integration has remained stable through recent updates, with no major breaking changes reported in 2026 sources. The connection process documented here reflects current best practices, though the ongoing improvements to Core Lightning support suggest that CLN users may see smoother remote access options in future releases.

For now, if you're setting up a new system and want the most reliable Zeus experience, LND on Umbrel with REST over Tor is the proven path. It works, it's private, and it puts full control of your Lightning funds in your pocket.