E2E:Troubleshooting

E2E troubleshooting

This page centralizes common E2E troubleshooting guidance. Platform-specific debugging sections live in Desktop E2E and Mobile E2E.

Allure Access

After a workflow run, you need to be connected to the green VPN to access the Allure report.

If the report is not accessible:

• Make sure the green VPN is connected.
• Try opening the report in an incognito window.

Environment Variables

Most local Speculos issues come from incorrect or missing environment variables. Check that these values are present and correct:

• MOCK
• COINAPPS
• SEED
• SPECULOS_IMAGE_TAG
• SPECULOS_DEVICE

For setup details, see E2E prerequisites & environment.

CoinApps Refresh

Some failures are caused by stale Nano app versions. Update the CoinApps repository:

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

Then re-export COINAPPS if needed.

Seed Changes

Do not paste a seed manually into your shell profile or a local file. Read it from 1Password:

export SEED=$(op read "op://Vault - QA Automation/Ledger Wallet E2E Seed/password")

To check whether the variable is loaded without printing the seed:

test -n "$SEED" && echo "SEED is set"

If you need a different seed, ask the QA Automation team which 1Password item to use.

Docker Cleanup

If tests fail or are interrupted, Docker containers may not be cleaned up correctly. Remove lingering containers so Speculos can launch on the expected port.

Transaction Broadcast

For local Desktop runs, disable transaction broadcast with:

DISABLE_TRANSACTION_BROADCAST=1 pnpm desktop test:playwright:speculos swap

For CI behavior, see Speculos transaction broadcast policy.

DS_Store Version Error

If .DS_Store files are present in unexpected locations, semver lookup can fail with:

TypeError: Invalid Version: DS_Store

Fix it by deleting .DS_Store files from the CoinApps and Ledger Live directories:

find . -name ".DS_Store" -type f -delete

CLI Issues

For CLI issues, see the Ledger Live CLI documentation.

Common Mobile Issues

Problem	Solution
Build fails	Remove previous iOS or Android builds, reinstall pods, and rerun the build command.
Environment variable not set	Check variables without printing sensitive values, for example test -n "$SEED" && echo "SEED is set". Export missing values again or update your shell profile to read secrets from 1Password.
Element not found	Add an explicit wait and verify the testId in application source code.
Simulator or emulator issues	iOS: erase all content and settings from Simulator. Android: wipe the AVD data from AVD Manager.

Platform Debugging

• Desktop debugging: PWDEBUG, DEV_TOOLS, feature flag userdata, and macOS deeplink handling.
• Mobile debugging: Detox flags, view hierarchy XML, screenshots, Metro devtools, and synchronization.