1. Get the App Builder Docker images

Estimated reading time: 2 minutes

Sections in this page

• The Docker images
• Getting the images

The Docker images

Building an app requires a specific compilation environment. Ledger provides Docker images containing all the required tools: the App Builder images.

There are currently three available images:

• the lite image, which is designed to be the lightest possible. It contains all needed tools to build a C-only application,
• the default image, based on the lite but with Rust capabilities. This image should allow to build all applications.
• the legacy image, which was the image used before late 2022. This image is much heavier, but is based on Ubuntu, and contains the glibc.

Getting the images

To use these container images, first install Docker on you computer. If you are using Docker Desktop, make sure Docker is running before using the following commands.

The Ledger App Builder images are regularly updated to fit the latest SDKs. They can be pulled with these commands:

# pull the default Docker image, which should be enough for most application
sudo docker pull ghcr.io/ledgerhq/ledger-app-builder/ledger-app-builder:latest
# pull the 'lite' Docker image, the smallest one which should be enough for C-only application
sudo docker pull ghcr.io/ledgerhq/ledger-app-builder/ledger-app-builder-lite:latest
# pull the 'legacy' Docker image, usefull if the glibc is needed
sudo docker pull ghcr.io/ledgerhq/ledger-app-builder/ledger-app-builder-legacy:latest

Don’t forget to regularly pull these images to keep them up to date. This way, your application will be compiled with the latest SDKs - which is a requirement if an application is to be deployed on Ledger official providers.

---

  Note
If for some reason you want to create or tinker these images yourself, you can find the related instructions on the project repository.

---

Did you find this page helpful?

How would you improve this page for developers?

I am a developer.
Contributors will be chosen randomly to receive rewards. Check this box to send your email and participate.

Ledger collects your email address to send you rewards for your contribution to improve the Developer Portal documentation. Learn more about how we manage your data and your rights.

By providing your email address, you consent that Ledger may contact you for rewards delivery purposes. If you are part of the randomly selected contributors, we will send you an email to ask for your physical address and if necessary, ask you for additional information on the suggestion you made. Your information will only be available to Ledger and will be retained for no longer than 90 days. It may be transferred to non-European countries that ensure an adequate level of protection or under the standard contractual clauses adopted by the EU Commission.

Please note that you may withdraw your consent at any time, access your data and request their rectification or deletion. You may also request the limitation of the processing of your data. To exercise your rights or for any question on the processing of your data, please contact LEDGER’s Data Protection Officer here. If nevertheless you believe LEDGER did not adequately address your concerns and mishandled your data, you may lodge a complaint with the personal data protection authority of your country.

Introduction

← Previous

2. Build the Application

Next →