Docs
chromia.com

Deploy your dapp to Mainnet

On this page

This topic covers deploying and updating a dapp with the Chromia CLI to the public Mainnet. For more information, see the deployment command.

Prerequisites

Deploy the dapp

  1. Copy the deployments key in the chromia.yml file example below into your config file. Replace the <ContainerID> with the Container ID you got from the Chromia Vault when you leased a container.
YAML
blockchains:
   hello: #Name of the blockchain
     module: main #Entrypoint to the project
 deployments:
   mainnet: #Deployment Target name
     container: <ContainerID> # Container ID (Example - container: 15ddfcb25dcb43577ab311fe78aedab14fda25757c72a787420454728fb80304)

Using mainnet as the deployment name automatically configures the brid and url for you. A custom deployment name would require these to be specified manually. See deployment configuration for more details.

  1. Execute the following command to deploy a specific chain to a specific target.

    Terminal
    chr deployment create --settings chromia.yml --network mainnet --blockchain hello

    By default, this command reads the keyId from the configuration file located at .chromia/config.

    • Windows: C:\Users\<YourUsername>\.chromia\config
    • macOS and Linux: /Users/<YourUsername>/.chromia/config or /home/<YourUsername>/.chromia/config

    If you prefer to use a different configuration file, you can specify the path using the --config option:

    Terminal
    chr deployment create --settings chromia.yml --network mainnet --blockchain hello --config <config file path>

    This allows you to set the keyId in a specific config file instead of the global configuration.

    After a successful deployment, you get the dapp Blockchain RID as a prompt in the terminal. It identifies your dapp for future deployments (updates). The prompt could look as follows:

    YAML
    Add the following to your project settings file
    deployments:
      mainnet:
        chains:
          hello: x"<BlockchainRID>" #Dapp Blockchain RID
  2. Add the chains key with the dapp name: **Blockchain RID** from the prompt to the chromia.yml file. This is important for updating your dapp in the future.

Great. You have now done your first deployment. Please see the Hello World Quickstart if you want to configure the client code to connect to your deployed dapp.

Update the dapp

Once you have done your first deployment, you can perform an update of your dapp.

Your chromia.yml must now have the chains config included.

YAML
blockchains:
  hello:
    module: main
deployments:
  mainnet:
    container: <ContainerID>
    chains:
      hello: x"<BlockchainRID>" #Dapp Blockchain RID

Run the following command to update your dapp:

Terminal
chr deployment update --settings chromia.yml --network mainnet --blockchain hello

To learn more about developing production-ready dapps, visit the Chromia course page.