Skip to content

E2E:Prerequisites

Victor Alber edited this page May 20, 2026 · 1 revision

E2E prerequisites & environment

Use this page for setup that applies across Ledger Live Desktop and Ledger Live Mobile E2E tests. Platform-specific build and run commands live in Desktop E2E and Mobile E2E.

Monorepo Setup

Clone the Ledger Live monorepo:

git clone https://github.com/LedgerHQ/ledger-live.git
cd ledger-live

Install mise, then install the pinned project toolchain from the repository root:

mise install

Mise manages the Node.js, pnpm, and related tool versions used by the monorepo. If you also have Node installed through tools such as nvm or asdf, make sure your shell uses the mise-managed version.

Then install dependencies as required by the platform page you are following:

Shared Requirements

  • Docker Desktop, used to run Speculos containers.
  • Ask access to the Vault - QA Automation 1Password vault for the E2E seed.
  • A local clone of the CoinApps repository.
  • The Speculos Docker image.
  • The Seed local setup guide for the full environment-variable setup.

CoinApps

Clone the CoinApps repository:

# HTTPS
git clone https://github.com/LedgerHQ/coin-apps.git

# SSH
git clone git@github.com:LedgerHQ/coin-apps.git

If local tests fail because app versions are stale, update the repository and re-export COINAPPS:

cd path/to/coin-apps
git checkout master
git pull origin master

CoinApps is an active repository, so pull the latest changes frequently.

Speculos Image

Pull the Speculos image:

docker pull ghcr.io/ledgerhq/speculos:latest

Seed Management

SEED is sensitive. It must never be committed, printed, or stored in a local file.

Use the 1Password CLI to read it from the QA Automation vault. Ask the QA Automation team for access to Vault - QA Automation if you do not have it.

For bash, zsh, or sh, you can load the seed only when your shell is currently inside the Ledger Live repository:

if [[ $PWD/ =~ /ledger-live/ ]]
then
  export SEED=$(op read "op://Vault - QA Automation/Ledger Wallet E2E Seed/password")
fi

For fish:

if string match -q '*/ledger-live*' (pwd)
  set -gx SEED (op read "op://Vault - QA Automation/Ledger Wallet E2E Seed/password")
end

1Password requests authorization once per terminal session. Keep this setup in your terminal profile only if it reads the value from 1Password and does not store the seed itself.

Environment Variables

Set the static variables from the environment guide:

export COINAPPS="/Users/firstname.lastname/coin-apps"
export SEED=$(op read "op://Vault - QA Automation/Ledger Wallet E2E Seed/password")

Set the framework-specific variables from the current E2E READMEs:

export MOCK=0
export SPECULOS_IMAGE_TAG=ghcr.io/ledgerhq/speculos:latest
export SPECULOS_DEVICE=nanoX

Notes:

  • Adjust COINAPPS to the path where you cloned the CoinApps repository.
  • Keep SEED secure by reading it from 1Password; do not paste the seed into a file.
  • Supported SPECULOS_DEVICE values include nanoSP, nanoX, nanoS, stax, flex, and nanoGen5.
  • To make variables permanent, add the commands to your shell profile, such as ~/.zshrc or ~/.bash_profile.
  • For non-static or framework-specific variables, check the platform README and wiki page.

Test Data CLI

Before running some Speculos tests, the CLI is used to create the required test data. This step ensures the scenario has the correct accounts, balances, or operations available.

For CLI troubleshooting and usage, see the Ledger Live CLI documentation.

Platform Setup

After completing the shared setup, continue with the platform-specific page:

Clone this wiki locally