Skip to main content

​
Install Medusa Wallet

Medusa Wallet is available for both iOS and Android devices. Choose your platform below to get started.

​
System requirements

​
iOS requirements

  • iOS version: 13.0 or later
  • Device: iPhone, iPad, or iPod touch
  • Storage: ~50 MB
Supported features:
  • Face ID authentication
  • Camera access for QR code scanning
  • Secure Keychain storage
  • Push notifications (coming soon)
Bundle identifier: bz.medusa.wallet

​
Download and install

​
Download from App Store

1

Open the App Store

Launch the App Store on your iOS device.
2

Search for Medusa Wallet

Search for “Medusa Wallet” or “Lightning Wallet Zero KYC”
3

Download and install

Tap the “Get” button and authenticate with Face ID, Touch ID, or your Apple ID password.The app will download and install automatically.
4

Open the app

Once installed, tap “Open” or find the Medusa Wallet icon on your home screen.

​
First launch

When you first open the app:
  1. You’ll see a splash screen with the Medusa logo
  2. The intro screen will appear with “Your Lightning Wallet With Zero KYC”
  3. Tap “Get Started” to create your account
On first launch, the app will request permission to access your camera (needed for scanning QR codes). You can always grant this permission later in Settings.

​
App configuration

After installation, the app comes pre-configured with:
  • Default LNbits server: https://wallet.medusa.bz
  • Language: Automatically detected from device (English/Portuguese)
  • Fiat currency: Based on device locale
  • Bitcoin unit: Satoshis (sats)
  • Theme: Automatic (follows system theme)
You can change all these settings later in the Settings menu, including switching to a custom LNbits server URL if you’re self-hosting.

​
Verifying the installation

To ensure you have the correct app installed:
  1. Check the app icon - it should show the Medusa logo
  2. The splash screen background should be #0A0A0A (dark black)
  3. The current version is displayed in Settings > App Version
Current version: 0.3.0

​
Version history

The latest version (0.3.0) includes:
  • Swaps and auto swaps with Boltz
  • Download and dismiss buttons for update notifications
  • Internationalization for wallet settings
  • Bug fixes for text wrapping and styling
See the full changelog for all updates.

​
Troubleshooting installation

​
Camera permissions not working

If the app can’t access your camera:
  1. Go to iOS Settings > Privacy & Security > Camera
  2. Find “Medusa Wallet” in the list
  3. Toggle on camera access
  4. Return to the app and try scanning again
Even without camera access, you can still use the wallet by pasting Lightning invoices and addresses manually.

​
App won’t install

  • iOS: Make sure you have enough storage space and iOS 13.0 or later
  • Android: Check that you have Android 5.0 (API 21) or higher
  • Try restarting your device and attempting the installation again

​
App crashes on startup

  1. Try force-closing the app and reopening it
  2. Check for system updates and install them
  3. Uninstall and reinstall the app (your data is stored on the server, so you can log back in)
  4. Report the issue on GitHub

​
Updating the app

Medusa Wallet will notify you when a new version is available:
  1. You’ll see a toast notification: “New version available”
  2. Tap “Download” to go to the App Store/Play Store
  3. Install the update
  4. Your account data and wallets are preserved across updates
The app checks for updates automatically by querying the GitHub releases API. You can also manually check by visiting your device’s app store.

​
Using a custom LNbits server

Advanced users can point the app to their own LNbits server: 
// The app uses this base URL by default
const BASE_URL = 'https://wallet.medusa.bz'

// You can change it in Settings > LNbits URL
1

Go to Settings

Open the Medusa Wallet app and navigate to Settings
2

Change LNbits URL

Scroll to “LNbits URL” and tap to edit
3

Enter your server URL

Enter your custom LNbits server URL (e.g., https://your-server.com)
4

Save changes

Tap “Save” - the app will verify the connection to your server
Only change the LNbits URL if you’re running your own server. Using an incorrect or malicious server could compromise your funds.

​
Next steps

Now that you have Medusa Wallet installed:

Quickstart guide

Follow our quickstart guide to create your account and send your first payment

Introduction

Learn about all the features and capabilities of Medusa Wallet

Build docs developers (and LLMs) love

Get started for freeTalk to us