Linux

Where Does CouchDB Store Data and Config?

CouchDB layers config in local.ini under /opt/couchdb with databases in the data folder beside it.

Last updated

CouchDB splits state between INI files and a data folder. Shipped defaults live in default.ini while local overrides belong in local.ini beside it. Databases persist as files in the data directory named by config.

Package layouts root these under /opt/couchdb while Docker images remap through volumes. Admin credentials hash into local.ini on first setup. Back up the INI files with the data folder for restores.

Where CouchDB stores this, by platform

Linux
/opt/couchdb/etc/local.ini

Local overrides on top of shipped defaults. Databases sit in /opt/couchdb/data by config. Docker volumes remap both paths.

Frequently asked questions

Where are my CouchDB databases?

As files in the data folder named by config, one set per database. Query _all_dbs to list them live. Copy with the node stopped for cold backups.

How do I back up CouchDB?

Replicate to a second node or copy the data folder stopped, plus local.ini beside it. Replication suits clusters while files suit singles. Test restores on staging.

Notice an outdated path? Let us know.