Chromia
Start Building

05 / 15Module 1: Project setupAdvanced

Deploy your Rell module

Once chromia.yml is configured, the container is leased, and the deployment key exists, you can deploy your Rell module to the Chromia testnet.

Install and build

From the rell/ folder, run:

bash
chr install      # Installs the vector_db library declared in chromia.ymlchr build        # Compiles your Rell module and validates the syntax

This installs the required dependencies and compiles the module so it is ready to deploy.

Deploy the module

Deploy the module with this command:

bash
chr deployment create --settings chromia.yml --network testnet --blockchain <your-chain-name> --key-id="vector_db_demo_key"
  • Replace <your-chain-name> with the same name you used under blockchains: in chromia.yml.
  • Set --key-id to the key you created earlier (vector_db_demo_key).

Update chromia.yml

When the deployment finishes, the CLI prints a chains: section. It looks similar to this:

yaml
deployments:  testnet:    brid: x"<directory-brid>"    url: https://node0.testnet.chromia.com:7740    container: <your-container-id>    # After deployment, insert the generated `chains:` section here    chains:      <your-chain-name>: x"<your-blockchain-rid>"

Copy that chains: block as-is into chromia.yml, under the testnet deployment entry. Do not edit it or swap in placeholders.

Verify the setup

Check that your configuration is valid by running:

bash
chr deployment update --settings chromia.yml --network testnet --blockchain <your-chain-name> --key-id="vector_db_demo_key"

With a correct setup, the command succeeds even when there is nothing to change. That confirms your deployment and configuration can accept future updates.

What’s next?

Your Rell module is deployed and chromia.yml is configured. The next step is to finish setting up your Python environment.

Written for this site from Chromia’s public course. Code samples are the course’s own.