How to Create Aion Desktop Wallet?

Aion Desktop Wallet

Here you will find more information on your Aion account, including set-up and interaction with the Aion Desktop Wallet.

Prerequisite: Aion Node

Please note that this wallet runs on your desktop and not through a cloud. As such, currently you will need to be running a fully synced node before you can successfully transact through the Aion Desktop Wallet.

Install Aion Desktop Wallet

  1. Download the Aion Desktop Wallet repository aion_wallet-{version}.tar.bz2
  2. Extract the folder to the desired directory
  3. Navigate to the newly created aion_wallet directory
  4. Open up the terminal here and run the command


This script will install the necessary components and launch the wallet interface. This window should open shortly:

How to Interact with Aion Wallet

Add an Account

There are two options to initialize your wallet by adding an account:

  • Recover Previous Wallet (if you have an existing Aion Desktop Wallet with the corresponding mnemonic and password)
  • Create New Account (new Aion Desktop Wallet user)
Recover Wallet
  1. Input mnemonic
  2. Input corresponding wallet password
Create a New Account
  1. Select an account name (this can be edited later)
  2. Select a password
  3. Confirm chosen password
  4. Save and backup the seed mnemonic that appears – you will need it if you wish to recover your wallet later:

Import Account

There are two options to import an existing account:

  • Import using a keystore file and password

  • Import using a private key (you will be asked to create a password for it)

Remember Me

There is a “Remember Me” option when importing accounts. Selecting this will display your imported accounts even if you re-launch your wallet. If this option is not selected, you will have to reimport these accounts if you re-launch the Aion Desktop Wallet.

Import with Keystore File

  • Click on the keystore space, and navigate to select your desired Keystore UTC File

  • Input corresponding keystore password:

Import with Private Key

  • Input your private key

  • Create a password to use to unlock the account (Note: input this password correctly, currently there is no way to change this password)

Export Account

You may wish to save your accounts created on the Aion Wallet elsewhere. In this case, you will need to export the wallet (using the icon right of the accounts listing) and save the keystore file in your desired location. Note that the password you input here will be the new password to access the keystore file:


  1. You have the option to transact AION and send it to another wallet. Note that this wallet must accept native AION coins.
  2. Make sure the account you wish to send AION from is unlocked under the “Accounts” listing (click on the lock icon to unlock an account)
  3. Navigate to the “Send” option in your wallet, and verify your account information on the left
  4. On the right panel, input the address you are sending to, and the amount to send in number of AION
  5. Click on “Generate transaction” to send the AION, and you will be notified when the transaction finishes

Handling Errors

Sending transaction…

Make sure that your Aion node is fully synced. You transaction will not occur unless it is up to date.

You have transactions that require your attention!

The transaction failed, click on the notification to open a pop-up where you may re-submit the transaction.

Receive AION

Under the “Receive” tab of the desktop wallet, you can send your public wallet address by:

  1. scanning the QR code to display the wallet address
  2. copying the address to your desktop clipboard

Additional Wallet Configuration

Connect with a Remote Node

If you wish to sync your wallet to an Aion node that is not running on your local machine, you may do so after making two changes in:

  • the configuration for the Aion kernel

  • your Aion Desktop Wallet “Settings” address

Configure Aion kernel

You will first have to ensure that the config.xml file found in the aion/config folder of your aion kernel repository is modified such that the Java API accepts remote access. This will allow your wallet to connect with the node.

  • Navigate to the aion/config/config.xml file

  • Change the IP address of the Java API section to

  • Save the config file and re-launch the kernel and wallet for changes to take effect


<java active="true" ip="" port="8547">


Configure wallet

After configuring the node you wish to connect to, you will need to change wallet settings so the IP address points to the machine running it.

  • Launch the Aion Desktop Wallet and navigate to the “Settings” tab

  • Change the IP from to the address of the machine currently running the Aion node you wish to connect to

  • Click “Apply” to save your changes

Delete or Switch the Wallet

If you wish to no longer use the wallet stored on your machine, or switch to another one, you have the option to delete the current wallet database and restart a fresh wallet (or restore an existing Aion wallet from its seed mnemonic).


The deletion of your wallet database is permanent – you will not be able to recover the accounts unless you have the mnemonic and password backed up.

By this, you complete this workshop successfully!!