Document the need to set couchdb/cookie

[eanyanwu]

Overview

It looks like the results of this issue did not make it into the docs. This lead to some weeping and gnashing of teeth while trying to do an UN-attended install on a ubuntu vm 😄

Happy holidays! 👋🏽 🎉

Testing recommendations

• Create Ubuntu VM on digital ocean for example (this was tested on 22.04)
• Log in and run these commands

# https://docs.couchdb.org/en/3.2.2-docs/install/unix.html
curl --silent https://couchdb.apache.org/repo/keys.asc \
    | gpg --dearmor \
    | tee /usr/share/keyrings/couchdb-archive-keyring.gpg >/dev/null 2>&1

source /etc/os-release

echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg] https://apache.jfrog.io/artifactory/couchdb-deb/ ${VERSION_CODENAME} main" \
    | sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null


# https://github.com/apache/couchdb-pkg/blob/main/debian/README.Debian
echo "couchdb couchdb/mode select standalone
couchdb couchdb/mode seen true
couchdb couchdb/bindaddress string 127.0.0.1
couchdb couchdb/bindaddress seen true
couchdb couchdb/cookie string monkey
couchdb couchdb/cookie seen true
couchdb couchdb/adminpass password safepassword
couchdb couchdb/adminpass seen true
couchdb couchdb/adminpass_again password safepassword
couchdb couchdb/adminpass_again seen true" | debconf-set-selections

apt-get --yes -qq update
DEBIAN_FRONTEND=noninteractive apt-get --yes -qq install couchdb

GitHub issue number

Related Pull Requests

Checklist

• [ ] Code is written and works correctly;
• [ ] Changes are covered by tests;
• [x] Documentation reflects the changes;

[eanyanwu]

I haven't personally deployed a clustered version before. I added a note saying that the cookie should be identical across all nodes (at least that's what I understand from the docs). Let me know if you think this is unnecessary (or wrong) to mention here.