> For the complete documentation index, see [llms.txt](https://docs.catalyx.solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catalyx.solutions/catalyx-blockchain-manager/canton-network/version-1.11/support-and-resources/faq.md).

# FAQ

This section covers answers to frequently asked questions about CatalyX Blockchain Manager and Canton Network operations.

{% hint style="info" %}
This page is a work in progress. More questions will be added over time.
{% endhint %}

## Backups, Identity Dumps & Retention

<details>

<summary>What's the difference between a database backup and an Identity Dump (IDDump)?</summary>

Database backups protect ledger and database state. Identity Dumps (IDDumps) protect validator identity and cryptographic keys. Both are required for full disaster recovery — neither can substitute for the other.

Learn more: [Validator Backups and Identity Dumps](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/identity-backup-and-recovery.md)

</details>

<details>

<summary>How long are security and audit logs retained?</summary>

30 days on Mainnet (Production), and 7 days on Devnet/Testnet.

Learn more: [Data Retention & Pruning Policy](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/data-retention-and-pruning-policy.md)

</details>

<details>

<summary>Does ledger pruning delete active data, and does it require downtime?</summary>

No to both. Pruning only removes obsolete ledger data that's no longer required for normal operation, and it runs as a scheduled maintenance task without requiring planned validator downtime.

Learn more: [Data Retention & Pruning Policy](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/data-retention-and-pruning-policy.md)

</details>

## Validator Upgrades

<details>

<summary>How often should I upgrade my validator, and does CatalyX auto-upgrade it?</summary>

CatalyX does not automatically upgrade validator nodes. Upgrades follow IntellectEU's validation of each Canton Foundation release before it's recommended for customer environments.

Learn more: [Validator Upgrade Policy and Release Schedule](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/validator-upgrade-policy-and-release-schedule.md)

</details>

<details>

<summary>Does every upgrade require a migration?</summary>

No. Only releases that introduce schema or application changes require a migration; others only update the validator application version.

Learn more: [Validator Upgrade Policy and Release Schedule](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/validator-upgrade-policy-and-release-schedule.md)

</details>

## KMS & Security

<details>

<summary>Can I use an external KMS (AWS, GCP, Azure) instead of storing validator keys directly?</summary>

Yes. Per-validator KMS is supported for storing participant keys with an external key management service.

Learn more: [KMS Integration](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/kms-integration.md)

</details>

## Networking & API

<details>

<summary>How do I expose the Ledger API for a validator?</summary>

Covers enabling gRPC vs. JSON Ledger API access and configuring Keycloak-based token authentication.

Learn more: [Expose Ledger API](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/expose-ledger-api.md)

</details>

<details>

<summary>Is there a REST API for triggering backups, restores, or pruning instead of using the UI?</summary>

Yes. 128 documented endpoints are available, including validator backup, restore, and prune operations.

Learn more: [API Reference](/catalyx-blockchain-manager/canton-network/version-1.11/support-and-resources/api-reference.md)

</details>

## Troubleshooting

<details>

<summary>Why can't I log into the wallet UI, or why is the Primary Party field showing an error?</summary>

See the troubleshooting table for common causes and resolutions.

Learn more: [Parties & Users](/catalyx-blockchain-manager/canton-network/version-1.11/network-and-node-management/parties-and-users.md)

</details>

<details>

<summary>Why did my DAR upload fail, or why don't templates appear after upload?</summary>

See the troubleshooting table for common causes and resolutions.

Learn more: [Upload DARs](/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/dar-management.md)

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.catalyx.solutions/catalyx-blockchain-manager/canton-network/version-1.11/support-and-resources/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
