Domains
This page introduces Domains (or Synchronizers) in Canton and explains how they are created and configured in Catalyst. Canton is a network composed of multiple domains, each operating under its own rules, governance, and set of participants. Each domain functions as an independent sub-network that participates in the wider Canton Network.
What is a Domain/ Synchronizer?
In a composed solution, each domain is a sub-network. A Participant Node connects to one or more Domains, enabling transactions that span Domains.

For more information about Participant nodes, see Participants.
How Do I Create a Domain?
To create a Domain, go to the Domains tab and click the Create button to open a side window.

Provide a Domain name
Enter a unique Domain name (required).
Fill in the main settings
Using a predefined image is recommended for compatibility. However, you can select your own image if needed. If you want to use an image from a private repository, specify an imagePullSecret. You can create an imagePullSecret in your Kubernetes cluster and reference it by name here.
Choose domain image
Enable Daemon if required
Enable Ingress if required
Resources allocation:
Requested CPU — Guaranteed CPU resources that will be allocated
CPU limit — Maximum CPU resources that will be allocated
Requested memory (MB) — Guaranteed amount of RAM that will be allocated
Memory limit (MB) — Maximum amount of RAM that can be allocated
Storage size
You can add custom environment variables if needed
Fill in Topology
Enable Embedded Topology if needed
Topology:
Choose between form or raw view topology
Choose Admin Port
Choose Public port
Choose Storage type:
No additional configuration required.
A PostgreSQL database will be provisioned in the cluster.
Choose User
Choose Password
Choose Storage size
When selecting PostgreSQL as storage type, a postgres database will be provisioned in the cluster.
A database is expected to be hosted at the given hostname and port, with the same name as the domain and a user with the provided credentials.
Choose User
Choose Password
Choose Hostname
Choose Port
Bootstrap (optional)
Provide bootstrap commands if needed.
Last updated
Was this helpful?