# Deployment overview

This section provides comprehensive guidance for deploying Ripple Custody in your environment. Follow the structured approach below to plan, configure, and install your custody solution.

## Deployment process

| Step | Phase | Description | Documentation |
|  --- | --- | --- | --- |
| 1 | **Planning** | Plan infrastructure, networking, database, messaging, and KMS | [Planning](#planning) |
| 2 | **Installation** | Deploy Ripple Custody using Helm charts | [Installation](#installation) |
| 3 | **Reference configuration** | Configure components and integrations | [Deployment reference](#deployment-reference) |
| 4 | **Verification** | Verify deployment and test functionality | [Register (UI)](/products/custody/identity-and-access/authentication/ui-authentication#register-and-log-in) | [Register (API)](/products/custody/identity-and-access/authentication/generate-api-keys-and-register) |


## Planning

Before deploying Ripple Custody, plan your infrastructure requirements. Follow the pages in order:

| Step | Topic | Description | Documentation |
|  --- | --- | --- | --- |
| 1 | **Personnel and expertise** | Required skills and team responsibilities | [Personnel and expertise](/products/custody/deployment/planning/readiness) |
| 2 | **Resilience** | Component HA/DR strategies and responsibilities | [Resilience planning](/products/custody/deployment/planning/resilience) |
| 3 | **Key management** | KMS/HSM selection (HSM vs MPC) | [Key management planning](/products/custody/deployment/planning/key-management) |
| 4 | **Blockchain nodes** | Blockchain node requirements and connectivity | [Blockchain node planning](/products/custody/deployment/planning/blockchain-nodes) |
| 5 | **Database** | PostgreSQL requirements and HA configuration | [Database planning](/products/custody/deployment/planning/database) |
| 6 | **Messaging** | AMQP/RabbitMQ requirements | [Message queue planning](/products/custody/deployment/planning/messaging) |
| 7 | **Networking** | Firewall rules, proxy, and TLS certificates | [Network planning](/products/custody/deployment/planning/networking) |
| 8 | **Secrets management** | Secret management and credential storage | [Secrets management planning](/products/custody/deployment/planning/secrets) |


## Installation

Deploy Ripple Custody using Helm charts:

| Topic | Description | Documentation |
|  --- | --- | --- |
| **Helm Charts** | Helm chart structure, values, and customization | [Installation environment setup](/products/custody/deployment/install/helm-chart-installation) |
| **Installation** | Step-by-step installation guide | [Installation and initialization](/products/custody/deployment/install/first-time-installation) |


## KMS integration

After installation, integrate your Key Management System. Ripple Custody supports HSM (Hardware Security Module) and MPC (Multi-Party Computation) key management approaches.

For a complete list of supported KMS platforms and integration guides, see [Key management system integration](/products/custody/deployment/integrate-kms/overview).

## Deployment reference

Use the deployment reference when you are ready to set Helm values for your environment:

| Topic | Description | Documentation |
|  --- | --- | --- |
| **Complete values.yaml reference** | Map Helm values to the correct reference page | [Deployment reference](/products/custody/deployment/reference) |
| **Infrastructure** | Database, AMQP, networking, URLs, and shared settings | [PostgreSQL](/products/custody/deployment/reference/postgresql), [AMQP](/products/custody/deployment/reference/amqp), [networking](/products/custody/deployment/reference/networking) |
| **Key management** | Vault, notary, HSM, and MPC configuration | [Vault configuration](/products/custody/deployment/reference/kms-vault), [notary configuration](/products/custody/deployment/reference/kms-notary), [MPC configuration](/products/custody/deployment/reference/mpc-configuration) |
| **Blockchain** | Ledgers, blockchain nodes, and indexers | [Ledgers](/products/custody/deployment/reference/ledgers), [blockchain nodes](/products/custody/deployment/reference/blockchain-nodes), [indexers](/products/custody/deployment/reference/indexers) |
| **Observability** | Telemetry and OTEL Collector configuration | [Telemetry configuration](/products/custody/deployment/reference/telemetry-configuration), [OTEL Collector deployment](/products/custody/operations-and-maintenance/monitoring/otel-collector) |


## Next steps

- **Start with planning**: Review all planning documents to understand requirements
- **Choose your KMS**: Review [Key management planning](/products/custody/deployment/planning/key-management) and select your KMS from the [KMS integration](#kms-integration) options.
- **Deploy with Helm**: Follow [Installation and initialization](/products/custody/deployment/install/first-time-installation) for step-by-step deployment.
- **Configure components**: Use the [deployment reference](/products/custody/deployment/reference) to customize your deployment.
- **Verify deployment**: Register as a user following [Register (UI)](/products/custody/identity-and-access/authentication/ui-authentication#register-and-log-in) or [Register (API)](/products/custody/identity-and-access/authentication/generate-api-keys-and-register)


**First time deploying?** Start with the [Design your governance model](/products/custody/governance/genesis) for a high-level overview, then return here for detailed deployment instructions.