Skip to content

Deploy Tonomy ID

Deployment of the full Tonomy ID involves several integrated services and is expected to take several hours for someone not familiar with the system

Please contact us for assistance in your on-site deployment, or to help run a fully managed service with updates.


  • Tonomy ID services run exclusively in Linux, we recommend Ubuntu 20.04 or 22.04.
  • npm with corepack enabled, we recommend v18.12.1. Suggested to install with nvm v0.35+

Services to run Tonomy ID



The easiest way is to use the automated scripts with the Tonomy-ID-Integration repository

Check the for dependencies and instructions.

git clone
cd Tonomy-ID-Integration
./ gitinit
./ install
./ init
./ start

On-site / cloud

We suggest that you look at the ./ and ./scripts/ files in the Tonomy-ID-Integration repository to get an idea of how to run and bootstrap the network.

Read the for each of the services before you start!

Then you will need to deploy each service, with configuration so that they connect with each other:

  1. Deploy an and initialize an Antelope blockchain - see the official Antelope node guide

    • For a production grade network, we suggest 3 nodes if run by the same entity, or 5 nodes if run by separate entities
    • For maximum scaleability, run using bare-metal servers.
    • Please contact us for assistance running a production Antelope network or setting up governance.
  2. Create the id.tmy account on the blockchain

  3. Deploy the id.tmy contract to the id.tmy account on the blockchain
  4. Register your applications that you wish to connect to Tonomy ID
  5. Configure the software with the config.json file in the repository so that they are connected correctly using your domains, and to white-label the applications:

  6. Create a new Google Play store and Apple App store listing.

  7. Use Expo or Expo Application Services to build Tonomy ID and submit it to your app store listings.
  8. Deploy Tonomy App Websites

    • You need to use the accounts. subdomain to run the Tonomy Accounts website
    • You need to use the demo. subdomain to run the Tonomy Demo website
  9. Deploy Tonomy Communication

(Optional) Sign blockchain transactions in your apps

If you want to have your applications sign blockchain transactions, see Sign a blockchain transaction for how to configure your smart contracts.

(Optional) Run the Demo website

To run the Demo website in your network follow these extra steps:

  1. Register the application using the domain you wish to run the Demo website from
  2. Deploy the eosio.token contract to the eosio.token account (or modify the Demo website to connect to a different account)
  3. Call addperm() function with the account name of the registered Demo application (Step 1)
  4. Create dummy accounts as shown in the bootstrap script here