Connecting to Databases and Queues

LlamaCloud requires a few external dependencies -- Postgres, MongoDB, Redis, and RabbitMQ.

Requirements

We officially support the following versions of the dependencies:

• Postgres
  • Minimum Version >=15.x
  • Admin Access to the database. LlamaCloud will read/write and apply migrations.
  • We recommend 1 - 2 vCPUs and 1 - 2 GBi RAM as a starting point for the database. As your usage grows, you can scale the database accordingly.
  • Recommended Managed Services:
    • Amazon RDS
    • Azure Database for PostgreSQL
    • Google Cloud SQL
• MongoDB
  • Minimum Version >=7.x
  • We recommend 1 - 2 vCPUs and 1 - 2 GBi RAM as a starting point for the database. As your usage grows, you can scale the database accordingly.
  • Recommended Managed Services:
    • Amazon DocumentDB
    • Azure Cosmos DB
    • Google Cloud
• RabbitMQ
  • Minimum Version >=3.11.x
  • We recommend 200 - 500m vCPUs and 500Mi - 2GBi RAM as a starting point for the database. As your usage grows, you can scale the database accordingly.
  • Recommended Managed Services:
    • Amazon MQ
    • Azure Service Bus
    • Google Cloud Marketplace
• Redis
  • Minimum Version >=7.x
  • We recommend 200 - 500m vCPUs and 500Mi - 2GBi RAM as a starting point for the database. As your usage grows, you can scale the database accordingly.
  • Recommended Managed Services:
    • Amazon ElastiCache
    • Azure Cache for Redis
    • Google Cloud Memorystore

External Dependency Configuration (Recommended)

To connect your LlamaCloud deployment to an external dependency, configure the necessary sections in your values.yaml file. Be sure to disable the subchart dependency as well. Otherwise, the external dependency configuration will be ignored.

Postgres

backend:
  config:
    postgres:
      enabled: true
      host: <host>
      port: <port>
      database: <database>
      username: <username>
      password: <password>
      # the above values can also be set in a secret object
      # existingSecretName: <secret-name>

# To disable the postgres subchart, set the following:
postgresql:
  enabled: false

MongoDB

backend:
  config:
    mongodb:
      enabled: true
      host: <host>
      port: <port>
      username: <username>
      password: <password>
      # the above values can also be set in a secret object
      # existingSecretName: <secret-name>

# To disable the mongodb subchart, set the following:
mongodb:
  enabled: false

RabbitMQ

backend:
  config:
    rabbitmq:
      enabled: true
      scheme: "amqp"
      host: <host>
      port: <port>
      username: <username>
      password: <password>
      # the above values can also be set in a secret object
      # existingSecretName: <secret-name>

# To disable the rabbitmq subchart, set the following:
rabbitmq:
  enabled: false

Redis

backend:
  config:
    redis:
      enabled: true
      host: <host>
      port: <port>
      password: <password>
      # the above values can also be set in a secret object
      # existingSecretName: <secret-name>

# To disable the redis subchart, set the following:
redis:
  enabled: false

Subchart Configuration

As a default, the LlamaCloud Helm Chart will deploy subcharts for the dependencies listed above. Please refer to the following pages for more information on the subchart configuration:

• PostgreSQL
• MongoDB
• RabbitMQ
• Redis