Ledger® Live Wallet – Getting Started™ | Developer Portal

Overview: This guide shows how to get started with Ledger® Live Wallet from a developer and advanced-user perspective — including setup steps, device onboarding, app and account management, sending & receiving, integration points, security best practices, and troubleshooting tips.

What is Ledger Live?

Ledger Live is the official desktop and mobile companion application for Ledger hardware wallets. It lets users manage multiple cryptocurrencies, install device apps, view portfolio analytics, and sign transactions securely using a Ledger hardware device. For developers, Ledger Live provides the user-facing flows that interact with the hardware device through the Ledger SDK, enabling secure signing, account management, and a plugin model for certain integrations.

Why developers should care

If you're building a dApp, wallet plugin, or integration that needs secure on-device signing, understanding Ledger Live's UX flows and the underlying device APIs is essential. Ledger Live is the common point of contact between end users and the secure element in the device; aligning your integration with its expectations leads to a smoother user experience and stronger security guarantees.

Prerequisites

  • Ledger hardware device (Ledger Nano S Plus or Ledger Nano X recommended).
  • A computer (Windows, macOS, Linux) or mobile device (iOS/Android).
  • Ledger Live desktop or mobile app installed and updated.
  • Familiarity with basic crypto concepts (addresses, private keys, seeds, signing).
  • For development: basic knowledge of REST/WebSocket APIs and optionally Node.js or a browser stack for integrations.

Download & Install

Get Ledger Live

Always download Ledger Live from the official Ledger site (links in the header). Choose the correct binary for your OS — Ledger provides installers for macOS (Intel & Apple Silicon), Windows, and Linux. For mobile, use the App Store or Google Play.

Installation checklist

  • Verify the download signature or checksum if available (security best practice).
  • Prefer the desktop app for development because it exposes more debugging and connectivity options.
  • Keep Ledger Live updated — features and device firmware compatibility change over time.

First run & device onboarding

On first launch, Ledger Live walks the user through creating or restoring an account. As a developer, know these user flows so you can craft integration steps that match the user's expectations.

Steps to onboard a device

  1. Open Ledger Live and select Get started.
  2. Choose Set up a new device or Restore device from recovery phrase.
  3. Follow the device screen prompts to choose a PIN and generate a recovery phrase.
  4. Install the Ledger Live apps for the coins you plan to use (via Manager).
  5. Create accounts inside Ledger Live for each coin you want to manage.
Tip — Recovery phrase handling

Never enter your recovery phrase into software on the computer. It should only be written on the recovery card or stored using a secure, offline method. Ledger will never ask you to enter your recovery phrase into Ledger Live.

Installing apps & creating accounts

Ledger devices use a modular app system: each cryptocurrency has its own app that you install via Ledger Live's Manager. After installing, you add accounts in Ledger Live to view balances and prepare transactions.

Developer notes on app management

For advanced integrations, understand that an app on the device exposes a protocol for signing and deriving addresses. Ledger's developer docs and GitHub repos provide reference implementations and APDUs (Application Protocol Data Unit) specifications for different coins and standards (e.g., BIP32, BIP44, EIP-155 for Ethereum).

Sending and receiving crypto

The ledger flow for sending funds requires preparing a transaction in Ledger Live (or another software wallet), then having the user confirm the exact transaction details on the device screen — this is the core security model.

High-level send flow

  • Build the unsigned transaction in your application (or let Ledger Live build it).
  • Send the unsigned transaction to the device for user confirmation.
  • User verifies details on the device and approves by pressing the hardware buttons.
  • Your app broadcasts the signed transaction to the network.
Developer integration points

If you're integrating with Ledger at the application layer, you typically either:

  • Use Ledger Live as the user's wallet (deep-linking / protocol handlers), or
  • Integrate Ledger device support directly into your app via the Ledger SDK (web/hid/bluetooth transports) while mimicking Ledger Live confirmation patterns for the user.

Security best practices (for devs & users)

Device-level security

  • NEVER ask users for their recovery phrase.
  • Encourage firmware and Ledger Live updates regularly.
  • Use the device screen to display human-readable transaction summaries where possible.

Developer-level security

  • Don't transmit sensitive data to third parties; keep signing deterministic and local.
  • Validate all data displayed to the user (don’t rely solely on the host app to format critical transaction fields).
  • Use deterministic derivation paths and make them visible to the user when relevant.

UX security tips

Prompt users to verify the destination address on the device for large transfers and display amounts in both crypto and fiat to reduce error. Provide clear guidance if the device rejects a transaction — usually due to protocol mismatches, wrong app version, or corrupted data.

Developer integration: the essentials

Developers integrate with Ledger devices in two main ways:

1. Using Ledger Live as the primary UX

Some dApps and services choose to rely on Ledger Live for the wallet experience and use protocol handlers / deep links to hand off signing responsibilities. This reduces integration complexity but offers less control over the UX.

2. Device integration via SDKs

Ledger provides libraries and tools for WebHID, WebUSB, and Bluetooth transports. Typical stacks include @ledgerhq/hw-transport-node-hid, @ledgerhq/hw-app-eth for Ethereum, and other app-specific modules. Refer to Ledger's GitHub for up-to-date libraries and examples.

Example flow for an Ethereum dApp
// Very high-level pseudo-flow
const transport = await Transport.create();      // connect to device
const appEth = new Eth(transport);
const address = await appEth.getAddress("44'/60'/0'/0/0"); // derive
const unsignedTx = buildTx(...);
const sig = await appEth.signTransaction("44'/60'/0'/0/0", unsignedTx);
broadcast(sig);
        

UI/UX guidance for a smooth integration

Align your product's messaging with Ledger Live's expectations. Use clear buttons such as Connect Ledger, provide step-by-step instructions, and show fallback help (e.g., "Is your Ledger unlocked and on the Ethereum app?"). If connection fails, show actionable troubleshooting steps with screenshots or links to support.

Accessibility & onboarding

Make onboarding incremental. For developer tooling, provide a "dummy" or testnet mode that uses only signature simulation until the user is ready to connect real funds.

Troubleshooting common problems

Device not recognized

  • Check cable & USB port (use a data cable, not a charging-only cable).
  • Unlock the Ledger and open the correct app on the device.
  • On desktop, try reinstalling Ledger Live or the transport drivers.

App errors or transaction rejected

  • Ensure the device app is updated and that the transaction format matches the app’s supported APDUs.
  • Large or complex transactions may exceed device limits — consider batching or using alternative signing strategies.

Testing and testnets

For development work, always use testnets or a dedicated test environment. Provide clear instructions in your integration for switching to testnets and include sample test funds and addresses. Ledger Live supports testnets for many chains — verify the current list in the docs when integrating.

Advanced topics

Custom transaction formats & multi-signature

If you’re building advanced flow (e.g., multisig or custom opcodes), you will often build the unsigned payload off-device, then send it to the device for signing. For multisig, be explicit about the public key origins and derivation paths, and provide UI that helps users understand the signing order and quorum.

Batching & UTXO management (Bitcoin-like chains)

When building for UTXO chains, manage change addresses carefully and display them to the user. Ledger Live's Bitcoin app expects familiar derivation patterns; ensure your wallet respects those to avoid confusing the user.

FAQ

Q: Can I replace Ledger Live with my own UI?

A: Yes — many wallets integrate the Ledger device directly. However, doing so means you must handle more security and UX responsibilities (connectivity, transaction building, user prompts), so weigh the trade-offs.

Q: Does Ledger Live store private keys?

A: No. Ledger Live never has access to private keys; those stay inside the secure element on the device. Ledger Live acts as a manager and transaction builder that delegates signing to the hardware.

Q: What if the device is lost?

A: Use your recovery phrase to restore on a new Ledger (or compatible wallet). For multi-sig setups, follow your organization's recovery procedures. Always keep recovery phrases offline and secure.

Conclusion & next steps

Ledger Live is a powerful, security-first companion for hardware wallets. For developers, the most valuable things to learn are the device signing model, the app transport stacks, and the UX flows users expect. Start by experimenting on testnets, follow Ledger's developer docs and GitHub, and design your integration to surface clear, verifiable information on the device screen so users make safe decisions.

Action checklist

  • Download Ledger Live and update firmware.
  • Install the coin-specific apps via Manager.
  • Familiarize yourself with transport libraries and signing APIs.
  • Build test flows on testnets first and validate UX on-device.
  • Document security guidance clearly for your users.

Visit Ledger Developers