Repository navigation
E2E:Prerequisites
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.
Clone the Ledger Live monorepo:
git clone https://github.com/LedgerHQ/ledger-live.git
cd ledger-liveInstall mise, then install the pinned project toolchain from the repository root:
mise installMise 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:
- Docker Desktop, used to run Speculos containers.
- Ask access to the
Vault - QA Automation1Password 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.
Clone the CoinApps repository:
# HTTPS
git clone https://github.com/LedgerHQ/coin-apps.git
# SSH
git clone git@github.com:LedgerHQ/coin-apps.gitIf 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 masterCoinApps is an active repository, so pull the latest changes frequently.
Pull the Speculos image:
docker pull ghcr.io/ledgerhq/speculos:latestSEED 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")
fiFor fish:
if string match -q '*/ledger-live*' (pwd)
set -gx SEED (op read "op://Vault - QA Automation/Ledger Wallet E2E Seed/password")
end1Password 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.
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=nanoXNotes:
- Adjust
COINAPPSto the path where you cloned the CoinApps repository. - Keep
SEEDsecure by reading it from 1Password; do not paste the seed into a file. - Supported
SPECULOS_DEVICEvalues includenanoSP,nanoX,nanoS,stax,flex, andnanoGen5. - To make variables permanent, add the commands to your shell profile, such as
~/.zshrcor~/.bash_profile. - For non-static or framework-specific variables, check the platform README and wiki page.
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.
After completing the shared setup, continue with the platform-specific page:
- Ledger Live Desktop
- Ledger Live Mobile
- Ledger Live E2E
- Ledger Live Common
- Assorted tips
- Integration Tests
- Process
- Monorepository Migration Guide
- Issues, Workaround and Tricks
- Common CI Troubleshooting
- Create staging builds using the CI