> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celo.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect Ledger to Celo CLI
How to connect a ledger wallet to the Celo CLI.
***
### Install the Celo CLI
Open the terminal application on your computer and install the [Celo CLI](/cli/):
```bash theme={null}
npm install -g @celo/celocli
```
If you have previously installed the CLI, ensure that you are using version 0.0.47 or later:
```bash theme={null}
celocli --version
```
And if not, upgrade by running the same command as above.
You will now need to point the Celo CLI to a node that is synchronized with one of Celo’s networks.
#### Configure the network
Connecting celocli to an untrusted node may allow that node to influence the transactions sent by the Celo CLI to the Ledger for signing. When in doubt, always use a node that you trust or are running yourself.
Configure the Celo CLI so that it uses a cLabs node on the Celo network.
```bash theme={null}
celocli config:set --node https://forno.celo.org/
```
Configure the Celo CLI so that it uses a cLabs node on the Celo Sepolia network.
```bash theme={null}
celocli config:set --node https://forno.celo-sepolia.celo-testnet.org/
```
#### Check that the node is synchronized to Celo CLI:
```bash theme={null}
celocli node:synced
```
The output should display `true`. If it displays `false` you may need to wait a bit and try again.
### Confirm Addresses on Celo CLI
The Ledger's current seed phrase determines the device's accounts. In the terminal on your computer, you can view the first account's address with the following command:
```bash theme={null}
celocli account:list --useLedger --ledgerAddresses 1
```
If you wish to generate more than one address from your seed phrase, you can display the first `N` (e.g. 10) addresses use the `--ledgerAddresses` flag.
```bash theme={null}
celocli account:list --useLedger --ledgerAddresses N
```
To display addresses at specific indexes `M`and `N`(e. 2 and 654) use the `--ledgerCustomAddresses "[M, N]"`flag
```bash theme={null}
celocli account:list --useLedger --ledgerCustomAddresses "[M, N]"
```
**Advanced:** Celo uses a [BIP-32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) derivation path of `m/44'/52752'/0'/0/index`, where `index >= 0`.
### Performing a Testnet transaction on Celo CLI
Before using your address on the Celo Mainnet, you may want to test it on the Celo Sepolia Testnet
with the following instructions.
Visit the Celo Sepolia Faucet and send yourself some testnet CELO at the following URL:
[https://faucet.celo.org/celo-sepolia](https://faucet.celo.org/celo-sepolia)
Check that you received the funds with the following command:
```bash theme={null}
celocli account:balance --node https://forno.celo-sepolia.celo-testnet.org
```
Next, you'll need to enable "Contract Data" in the ledger app. Open the Celo App on your ledger device and go to Settings, then enable "Contract Data" to "Allowed". This setting is required because the celocli uses the ERC20 "pre-wrapped" version of CELO and so sending transactions requires sending data to a smart contract.
Perform a test transaction by running the following command:
```bash theme={null}
celocli transfer:gold --from= --to=0x0000000000000000000000000000000000000001 --value=10000 --useLedger --node https://forno.celo-sepolia.celo-testnet.org
```
You'll need to then approve the transaction on the Ledger device. Toggle right on the device until you see `Approve` on screen. Press both buttons at the same time to confirm.
Finally, you can see if your transaction was mined on the network by copying the transaction hash (txHash) outputted by the command, and searching for it on the [Celo Sepolia Block Explorer](https://celo-sepolia.blockscout.com).
### Using `celocli`
You can use `celocli` to securely sign transactions or proof-of-possessions with your Ledger.
To use `celocli` with your Ledger, ensure the device is connected to your computer, unlocked, and the `Celo` app is open and displaying `Application is ready`.
Then, simply append the `--useLedger` flag to any `celocli` commands with which you'd like to use a Ledger. You may also append the `--ledgerConfirmAddress` flag, which will require that you manually verify on the Ledger the address from which the transaction is being sent.
## View Account Balance
In order to view your account Balance on your Ledger with `celocli`, you need to run the following command:
```sh theme={null}
# If you haven't set the node config to Mainnet, do it first
celocli config:set --node=https://forno.celo.org
celocli account:balance
```
This will display the specific account balance for your address on Celo Mainnet.
## Receive Crypto Assets
In order to receive Celo on your address, whether it's CELO or USDm or any Mento stablecoin, you must share your specific address with the sender.
Once a sender has confirmed they sent you the assets to your Ledger address, ask for the transaction ID which you can lookup on the [Explorer](https://celo.blockscout.com/).
## Send Crypto Assets
In order to send CELO or USDm from your Ledger, you just need a recipient address to send to. Once you have that and the amount you would like to send (in our example, 10 CELO), we will go over how to send CELO using `celocli`.
```sh theme={null}
celocli transfer:gold --from= --to= --value=10 --useLedger
```
You'll need to then approve the transaction on the Ledger device. Toggle right on the device until you see `Approve` on screen. Press both buttons at the same time to confirm.
You'll then get a transaction hash when it's confirmed that the transaction was mined by the network, and you can check the status of the transaction on the [explorer](https://explorer.celo.org).
## Troubleshooting
If you have issues connecting to the Ledger, try the following:
* Check that the Ledger device is connected, powered on, and that you've unlocked it using the PIN.
* Check that no other applications are using the device. Close Ledger Wallet. Stop any local Celo Blockchain node, or ensure it is run with the `--usb` option.
* Try unplugging and replugging the device. Some devices appear to trigger a warning on Macs saying: “USB Devices Disabled. Unplug the device using too much power to re-enable USB devices” which is usually resolved by reconnecting.
* Ensure that you are using the original cable supplied with your Ledger.
* Ensure that your Ledger has the [latest firmware](https://support.ledger.com/hc/en-us/articles/360002731113-Update-device-firmware). For Ledger Nano S, a firmware version of 1.6 or later is required.
* Ensure that you are running the latest version of the Celo CLI.
There have been reports of a possible [issue](https://github.com/celo-org/celo-ledger-spender-app-archived) that appears to affect developer store apps on the Ledger Nano X including the Celo Ledger App. This is believed to be fixed in version 1.0.3. In earlier versions, a user clicking through the `Pending Ledger review` notice too rapidly can cause the device to freeze. If this occurs, wait until the device's battery is depleted, then charge and power up again. Then use Ledger Wallet Manager to update the installed version of the Celo Ledger App.