> 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-package-manager.md).

# CatalyX Package Manager

CatalyX Package Manager (CPM) is a web-based package management platform for the Canton Network, designed to streamline the application distribution process with enterprise-grade reliability and control.\
\
CPM replaces ad-hoc file sharing with a standardised approach, ensuring Canton Network participants stay up to date with the latest application versions and reduce the operational risk that comes with deploying across a distributed network.

<figure><img src="/files/gFm5jYigYH6iRtgX6h4l" alt=""><figcaption></figcaption></figure>

***

### CatalyX Package Manager Overview

<details>

<summary>How It Works</summary>

CatalyX Package Manager provides an intuitive, user-friendly console where Canton Network participants can discover, distribute, and download application packages.

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><ol><li><strong>Discover</strong></li></ol></td><td>Explore packages published by application providers on the Canton Network.</td></tr><tr><td><ol start="2"><li><strong>Distribute</strong></li></ol></td><td>Publish your own packages, control who has access, and notify users when new versions are released.</td></tr><tr><td><ol start="3"><li><strong>Download</strong></li></ol></td><td>Easily download and deploy application packages to your Canton node.</td></tr></tbody></table>

</details>

<details>

<summary>Key Features</summary>

1. **Streamlined Package Distribution**\
   Use CPM's central registry for publishing, distributing, and downloading application packages with full lifecycle visibility.
2. **Version & Lifecycle Management**\
   Manage multiple versions of a package, track updates, and guide safe upgrades using clear version history.
3. **Private Access Controls**\
   Support institutional requirements through package access controls, verified publisher credentials, deprecation warnings, and auditable access history.
4. **Managed Artifactory Hosting**\
   Host application artifacts directly within the CPM platform using a managed, highly available artifactory, no external repositories needed.
5. **Notifications and Subscriptions**\
   Notify your clients through email when new package versions are uploaded to CPM.

</details>

<details>

<summary>Security &#x26; Privacy</summary>

CPM is designed so that your credentials never leave your own infrastructure. The platform runs in your browser and communicates directly with your Canton node — IntellectEU's servers never receive or store your authentication tokens or node credentials. There are no user accounts on the CPM side; authentication is handled entirely by your organisation's own identity provider.

</details>

<details>

<summary>Learn More</summary>

{% embed url="<https://www.catalyx.solutions/catalyx-package-manager>" %}

</details>

***

### Get Started

Explore the documentation and discover how you can use CatalyX Package Manager to streamline your package management lifecycle.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Registration Guide</strong></td><td>A step-by-step manual to register and download the CPM application.</td><td></td><td><a href="/pages/NwY7u3DS2zoUxiGxZgfN">/pages/NwY7u3DS2zoUxiGxZgfN</a></td></tr><tr><td><strong>User &#x26; Console Guide</strong></td><td>Everything you need to navigate the console and get the most out of CPM.</td><td></td><td><a href="/pages/moEaNU7Yzee14gPcmADg">/pages/moEaNU7Yzee14gPcmADg</a></td></tr><tr><td><strong>Release Notes</strong></td><td>Explore the latest updates, improvements, and bug fixes.</td><td></td><td><a href="/pages/HoaWfafvBVJDQQbesI7s">/pages/HoaWfafvBVJDQQbesI7s</a></td></tr></tbody></table>

***

### Frequently Asked Questions

<details>

<summary>Why do I need to install a DAR file on my Canton node to use CPM?</summary>

CPM uses the Canton ledger as its primary record of state, rather than a centralised database. Installing the CPM DAR file on your validator node lets every core platform action, such as registering a package, granting access to it, or approving a publish request, be recorded as a smart contract transaction on the ledger. This makes each action visible and independently verifiable by every relevant party: for example, the party ID shown as a package's publisher can always be checked on-ledger to confirm it is indeed the party ID that published that package.

</details>

<details>

<summary>How do I know a published package hasn't been tampered with, even if the registry itself were compromised?</summary>

Every package registered on CPM has its cryptographic hash recorded directly in its DAML contract on the Canton ledger. Before deploying a package, you can compute the hash of the DAR file you actually retrieve and compare it against the value recorded on-ledger. If the two match, you have cryptographic proof that the file is exactly what the publisher registered, independent of CPM's own infrastructure.

</details>

<details>

<summary>How does authentication work in CPM?</summary>

CPM is designed so that your credentials never leave your own infrastructure. The platform runs entirely in your browser and communicates directly with your own Canton node, so IntellectEU's servers never receive or store your authentication tokens or node credentials. There are no user accounts on the CPM side; authentication is handled entirely by your organisation's own identity provider.

</details>

<details>

<summary>What's the difference between a public and a private package?</summary>

When publishing a package, you choose its access model. **Public** packages can be downloaded by any registered CPM user. **Private** packages require a user to submit an access request, which the publisher can approve, deny, or revoke at any time from My Library.

</details>

<details>

<summary>Where are package DAR files actually hosted?</summary>

You choose the hosting when you publish a package: either upload the DAR file directly to CPM's managed artifactory, or host it yourself and provide an external artifactory link (public packages only).

</details>

<details>

<summary>How will I know when a package I use gets updated?</summary>

You're automatically subscribed to update notifications whenever you download a package or click its favourite ("star") icon. When the publisher releases a new version, you receive an email notification, and the package's full version history remains available on its detail page. Manage all your subscriptions from the Notifications & Subscriptions tab.

</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-package-manager.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.