Skip to content

Manually creating an account

If you want to use the Bakerloo testnet to deploy and interact with an application we recommend that you manually create an account using the guide below.

If instead you want to send and receive AUT on the Autonity Bakerloo testnet, or run a node, you may skip this section and rely on the in-built functionality of tools like MetaMask to create a new account.


An account is simply a public-private keypair, saved in a keystore file, that corresponds to an address on the Autonity blockchain

Account creation

This guide uses standard Unix commands and the Autonity Go Client running in a Docker container, to create the keystore.

  1. Create a directory to hold your account details files:

    mkdir autonity-testnet-account
    cd autonity-testnet-account
  2. Create a file that contains the passphrase you want to use for encrypting the keystore file:

    echo "<PASSPHRASE>" > keystorepassphrase
  3. Use the Autonity Go Client to generate a keypair within a keystore file:

    docker run --rm \
    --user $(id -u):$(id -g) \
    -v $(pwd):/root \ account new \
    --keystore /root --password /root/keystorepassphrase

    The keystore file will have a name starting with UTC and ending with your account address.


Ensure that your keystore file is stored securely. You may want to delete the keystorepassphrase file, but do make sure you remember the passphrase!

Import your account into wallet applications

Standard tools such as MetaMask have a functionality to import a private key.

If you want to use your newly created account with MetaMask, go to > My Accounts > Import Account, set the value of Select Type to JSON File browse for the keystore file you just created, and supply the keystore passphrase; then click "import". MetaMask may take some time to unlock the key, and you may need to tell the browser to wait several times before the operation completes.

To verify that the account has correctly been imported, compare the account address that MetaMask derives from the key, with the address you have generated.


If you need help, you can: