Skip to content
Start freeMenu

§ Databases · Document

CouchDB backups, natively.

CouchDB's append-only files are safe to copy while it runs, so the default is a file backup of the data and configuration. A logical couchbackup mode exists for databases without attachments.

What Xtic runs

tar
tar -C /opt/couchdb/data -cf - .shards shards _dbs.couch _nodes.couch _users.couch

Shown with placeholders. Credentials never appear on a command line: they reach the tool through the environment, a file descriptor or a short-lived file in memory.

Restore paths

  • Files: stop, replace the directories, start — on a node with the same name
  • Logical: couchrestore into a new, empty database

Verification

Document counts compared with the source. Every artifact is also hashed, and the stored copy is read back and compared before the run counts as verified.

Version rule

Same or newer 3.x.

Good to know

  • couchbackup skips attachments, so Xtic blocks the logical mode when a database has them
  • Licence and editions: Apache 2.0.

More databases