Restore CouchDB from .couch files

[defremont]

I'm trying to backup and restore a CouchDB following the official documentation:

https://docs.couchdb.org/en/latest/maintenance/backups.html

"However, you can also copy the actual .couch files from the CouchDB data directory (by default, data/) at any time, without problem. CouchDB’s append-only storage format for both databases and secondary indexes ensures that this will work without issue."

Since the doc seems to not show clearly the steps to restore from files, i copy the entire data folder, build up a local CouchDB docker container and try to paste the files into container opt/couchdb/data folder.

But what i get when i start/restart the container and access localhost:5984 to see the databases, is: "This database failed to load."

What should i do after copy the files? Paste directly should work? What is the right time to paste? Should i create the DBs before?

Thank you all

[wohali]

Check that your vm.args file has the same node name as the other machine. You're looking for the line that starts with -node and by default is either -name couchdb@127.0.0.1 or -name couchdb@localhost.

Otherwise you will need to edit the shard maps for every database in the special node-local _dbs database, which can be a pain.

[defremont]

Thank you! I had to change every shard name to the new names after create the DBs in the target CouchDB.

[tvreddydba]

Thank you! I had to change every shard name to the new names after create the DBs in the target CouchDB.

could you pleas share steps to change every shard name to the new names after create the DBs in the target CouchDB

[zlawson-ut]

^^ 👁️

[dsalex1]

Thank you very much. This also helped migrating from a standalone CouchDB installation to Docker with the official couchdb image. In my case the standalone installation has a default name of 127.0.0.1, in docker however its not set per default, adding NODENAME: 127.0.0.1 as environment fixed it.

[varsha-rav]

Hi, I'm facing the same issue and cross checked the vm.args file as well. Couchdb data was copied from cloud to linux env, the data was copied one shard folder at a time and post spinning up couchdb on linux env, we're seeing this issue of "This database failed to load." I have verified the file ownership of the couchdb data as well and can see its as expected. Could you please share steps to change every shard name to the new names ? Or if there any other suggestions ? Appreciate any help. Thanks