# Manage Catalogs

There are two types of Catalogs that are available to the user:

- **Custom Catalogs:** Allows users to create custom catalogs within a project and selectively add applications as required
- **System Catalogs:** Includes a curated list of applications available by default in the system

## Custom Catalogs

Custom Catalogs can be used to:

- Add applications on top of what is already available with System Catalogs
- Control the available list of applications (and versions) to deploy as an add-on or a workload. It is possible to standardize Custom Catalogs by creating them centrally and sharing them across projects. Custom Catalogs can reference and sync from any public or private helm repositories

Perform the below steps to create **Custom Catalogs**

- Create a **Repository**, instructions to create a new repository can be found [here](https://docs.rafay.co/integrations/repositories/manage_repos/), this can point to any public or private Helm repository

**Note**  
If no agent is specified for an internet-accessible endpoint, the controller’s hosted agents will be used (not recommended for production). For production environments, it is recommended to configure agents while considering factors such as rate limits enforced by registries like Docker Hub.

- Click **Manage Catalogs** from the Browse Catalog Apps page

- Custom Catalogs page appears by default showing the list of catalogs created by the users
- Click **New Catalog** from the Custom Catalog page
- Enter a name for the new catalog and select a **Repository** from the drop-down
- Enabling **Auto Sync Catalog** automatically refreshes the catalog page on any updates to the repository
- Optionally, add one or more Helm charts, and click **Create**

> **Note**:
>
> - If the OCI Helm Repository endpoint includes only the host (`oci://c8n.io`), catalogs can add charts with namespace paths if applicable, such as `demouser1/airflow` or `demouser2/nginx`.
> - If the OCI Helm Repository endpoint includes the host along with the namespace (e.g., `oci://c8n.io/demouser1`), users can specify any charts available under that namespace, such as `airflow` or `nginx`.
> - Charts are optional if the repository credentials have access to list the repositories for the given domain. For more information, refer to [OCI Helm Repository Creation](https://docs.rafay.co/integrations/repositories/manage_repos/)

- On creation of the Custom Catalog, a sync can be initiated manually

- View the list of custom catalogs in the Manage Catalogs page

- Use **Manage Sharing** icon to share the catalogs with one or more project(s)
- Click **Sync Catalog** icon to sync from the selected repository
- Use **Delete** icon to delete the custom catalogs

## System Catalogs

**System Catalogs** page shows the available default catalogs, clicking on a particular system catalog shows the list of available applications

**Important**  
Users cannot **edit** or **delete** the **System Catalogs**

It is possible to disable one or more of the System Catalogs. The applications included in those System Catalogs will be unavailable across all projects.

- Click on Home -> SYSTEM and select Settings from the drop-down menu
- In the Catalog Setting section, disable System Catalogs as appropriate