Skip to content

Databases

Managed CouchDB on your own cluster

Document database with sync built in: JSON over HTTP, and replication that lets PouchDB and mobile apps work offline.

Created inside a project, beside the apps that use it. Each project gets its own instance, storage and credentials.

A recent addition. It installs today, and the console marks it as new until it has run on a customer's cluster.

01What it does

CouchDB, run for you

CouchDB on the Apache chart, as a single node.

The database for apps that have to keep working when the network does not. Documents are JSON over plain HTTP, and replication is part of the database rather than something bolted on, so a PouchDB in the browser or a mobile client can work offline and catch up later.

A single node; replicate to it or from it. Open databases and view indexes are held in memory, so the size decides how many stay fast. The HTTP API, and Fauxton with it, can be published on a hostname.

02Options

What you choose

What the console asks when you create it, in the catalog's own numbers. Anything marked chosen once cannot change without creating a new instance.

Sizes
small 512Mi, medium 2Gi, large 4Gi of memory
Storage
10Gi by default, chosen once
Hostname
The HTTP API (5984) can be published on a domain
Pause
Yes; the volume is kept

03Binding

What your app receives

Bind it to an app and these arrive as environment variables. The values are generated once into a secret and reach the app from there, rather than as something you copy.

  • COUCHDB_HOST
  • COUCHDB_PORT
  • COUCHDB_USERNAME
  • COUCHDB_PASSWORD
  • COUCHDB_URL

04Adding it

Add CouchDB to a project

The same four steps as every service in the catalog.

  1. 01Open a project and go to Services.
  2. 02Pick it from the catalog and choose its options. Only the size is required; everything else has a default.
  3. 03Create it. Anyport installs it into the project's namespace, generates its credentials into a secret there, and tracks its health.
  4. 04Bind it to an app. The connection details arrive as environment variables, and rotating the credential never means editing an app.