couchdb
couchdb:latest
https://hub.docker.com/_/couchdb
bridge
bash
false
https://forums.unraid.net/topic/198811-support-junkerderprovinz-unraid-apps/
https://couchdb.apache.org
https://github.com/junkerderprovinz/unraid-apps/blob/main/couchdb/README.md
Apache CouchDB is a document database that speaks HTTP and stores JSON. It is the sync
backend behind Obsidian LiveSync and many offline-first apps. This is a plug-and-play
Unraid Community Applications template that wraps the official couchdb image (3.x),
fixed so your data and settings actually survive a container recreate or update.
WHY THIS TEMPLATE EXISTS: the old community CouchDB template maps the 1.x data path
(/usr/local/var/lib/couchdb). On the current 3.x image the real data lives in
/opt/couchdb/data and the config in /opt/couchdb/etc/local.d - if those are not mapped,
your databases sit in an anonymous Docker volume and CORS resets on every recreate.
This template maps both to appdata, so nothing is lost.
FIRST-RUN SETUP (two quick steps, see the README):
1. Set an Admin User + Admin Password below (CouchDB 3.x will not start without an admin).
2. After it starts, finish the single-node setup so the system databases are created -
run once on the Unraid console (replace IP / user / pass):
curl -X POST -u admin:PASS http://SERVER_IP:5984/_cluster_setup -H "Content-Type: application/json" -d '{"action":"enable_single_node","bind_address":"0.0.0.0","username":"admin","password":"PASS","port":5984,"singlenode":true}'
OBSIDIAN LIVESYNC / BROWSER APPS need CORS. The image regenerates docker.ini from the
admin env on every start, so CORS set in Fauxton is wiped on recreate. Instead drop a
persistent file at appdata/couchdb/local.d/10-cors.ini (full contents in the README) -
it is preserved forever. Then browse to http://SERVER_IP:5984/_utils/ (Fauxton).
Detailed README (setup, CORS file, backup, reverse proxy): https://github.com/junkerderprovinz/unraid-apps/blob/main/couchdb/README.md
Tools:Utilities
http://[IP]:[PORT:5984]/_utils/
https://raw.githubusercontent.com/junkerderprovinz/unraid-apps/main/couchdb/couchdb.xml
https://raw.githubusercontent.com/junkerderprovinz/unraid-apps/main/couchdb/icon.png?v=2
If this template helps you, consider buying me a coffee.
https://buymeacoffee.com/junkerderprovinz
Set an Admin User and Admin Password below (CouchDB 3.x will not start without one). After first start, run the single-node setup so the _users / _replicator / _global_changes system databases are created - see the README. For Obsidian LiveSync or any browser client, add appdata/couchdb/local.d/10-cors.ini (contents in the README) to enable CORS persistently.
5984
/mnt/user/appdata/couchdb/data
/mnt/user/appdata/couchdb/local.d
admin