In this Briefing, IBM’s Josh Mintz and Will Holley will show us   how to operationalize the Operator for Apache CouchDB.  Apache CouchDB’s unique data sync capabilities are particularly useful for OpenShift applications that require data portability between private and public clouds.
Apache CouchDB lets you access your data where you need it. The Couch Replication Protocol is implemented in a variety of projects and products that span every imaginable computing environment from globally distributed server-clusters, over mobile phones to web browsers.

Store your data safely, on your own servers, or with any leading cloud provider. Your web- and native applications love CouchDB, because it speaks JSON natively and supports binary data for all your data storage needs.

The Couch Replication Protocol lets your data flow seamlessly between server clusters to mobile phones and web browsers, enabling a compelling offline-first user-experience while maintaining high performance and strong reliability. CouchDB comes with a developer-friendly query language, and optionally MapReduce for simple, efficient, and comprehensive data retrieval.

Operator for Apache CouchDB Features

  • Fully automated deployment and configuration of Apache CouchDB clusters.
  • Support single, multiple, or all namespace install modes.


  • TLS – TLS is supported by using user-provided certificates.
  • Authentication – The parameter require_valid_user defaults to true, which means that no requests are allowed from anonymous users. Every request must be authenticated.
  • Authorization – Databases are initially accessible by Apache CouchDB admins only.

High Availability

  • Nodes – Each database node in an Apache CouchDB cluster requires its own Kubernetes node. It’s recommended that you run it with a minimum of three nodes for any production deployment.
  • Zones – The Apache CouchDB cluster database nodes are spread across available Kubernetes fault zones where available.
  • Replicas – The default configuration for each database is eight shards (Q=8) and three shard copies (N=3), where each shard copy is deployed on a separate node in the cluster.

Reading and writing to Apache CouchDB

The Operator for Apache CouchDB automatically generates a Service. This can be accessed using port-forwarding e.g. kubectl port-forward svc/my-couchdb-cluster 5984:5984 -u admin:mypassword. Alternatively, configure a Kubernetes Ingress to expose the service externally.

Read the complete guide to using the Operator for Apache CouchDB

Here are the Briefing Slides

Additional Resources:

To stay abreast of all the latest releases and events, please join the OpenShift Commons and join our mailing lists & slack channel.

What is OpenShift Commons?

Commons builds connections and collaboration across OpenShift communities, projects, and stakeholders. In doing so we’ll enable the success of customers, users, partners, and contributors as we deepen our knowledge and experiences together.

Our goals go beyond code contributions. Commons is a place for companies using OpenShift to accelerate its success and adoption. To do this we’ll act as resources for each other, share best practices and provide a forum for peer-to-peer communication.

Join OpenShift Commons today!


OpenShift Commons, Operators, OpenShift 4

< Back to the blog