Skip to main content

Getting started

Deploying a decentralized application (dapp) to the Chromia testnet involves several key steps. Here's an overview of the process, with each step explained in more detail in the subsequent pages.

Step 1: Obtain a container for your dapp​

Your dapp needs a container, which serves as its operational environment. Here's how to get one:

  1. Generate a public-private key pair: Use the Chromia CLI to generate a public-private key pair specifically for the testnet container. This key pair is separate from the wallet used to receive test tokens.
  2. Lease a container: Go to the Chromia staking page and lease a container. This process will give you a Container ID necessary for deployment.

Step 2: Deploy your dapp​

Once you have secured your container, follow these steps to deploy your dapp:

  1. Update configuration: Add your deployment specifics, including the Container ID, to your project configuration file (chromia.yml). Detailed instructions can be found here.
  2. Execute deployment: Use the Chromia CLI to execute the deployment command. Specify your network (mainnet) and blockchain name.
  3. Receive blockchain RID: Upon successful deployment, you will receive a unique Blockchain RID for your dapp. This is essential for future updates and client connectivity.

Step 3: Connect a client​

To enable user interactions, you must connect a client to the backend of your deployed dapp:

  1. Specify node URLs and Blockchain RID: Configure the client by specifying a pool of system node URLs where your dapp is running and the Blockchain RID specific to your dapp.
  2. Complete configuration: Follow the steps outlined here to complete the configuration.

By completing these steps, you will have successfully deployed a fully functional dapp to the Chromia testnet. The next few pages explain each of the steps in more detail.