# couchdb

couchdb is a self-hosted databases app. Apache CouchDB is a document database that speaks HTTP and stores JSON. It is open source and self-hosted, installable on Kubernetes (Helm) and Unraid.

Canonical page: https://ourlocalhost.com/app/7192/couchdb

## Description

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

## Platform availability

Available on 2 of 9 platforms: Unraid, Helm.

## Links

- Kubernetes (Helm): https://artifacthub.io/packages/helm/couchdb/couchdb
- Unraid: https://ca.unraid.net/apps/couchdb-064b10p1xt53et?q=couchdb
- Official website: https://couchdb.apache.org

## Common questions

### Can a single-node CouchDB deployment be upgraded to a cluster?

Yes. CouchDB can start as a single-node instance and be upgraded to a cluster for more demanding projects.

### Can CouchDB store binary data for web and native applications?

Yes. CouchDB speaks JSON natively and supports binary data.

### What should I check if a Tailscale funnel LiveSync setup is failing?

Check the Tailscale funnel activation and the CouchDB side of the setup.

### Does self-hosted LiveSync support iPhone use?

Yes. Obsidian LiveSync is an Obsidian plugin and supports native iOS use.

## Alternatives

- ArangoDB: ArangoDB database is an open-source NoSQL solution with a flexible data model for documents, graphs, and key-values.
- FerretDB: FerretDB is an open-source MongoDB compatibility proxy for self-hosted stacks.
- Firestore: Firestore is a NoSQL document database built for automatic scaling, high performance, and ease of application development.
- Microsoft SQL Server: SQL Server delivers on Microsoft’s Data Platform vision by helping your organization manage your data by enabling you to store data from st…
- MongoDB: MongoDB is a cross-platform, open-source document-oriented NoSQL database that stores data in flexible, JSON-like BSON documents instead of…
- MySQL Community Edition: Free GPL database platform supporting SQL and NoSQL applications with InnoDB storage, replication, clustering, connectors, and cross-platfo…
- PostgreSQL: PostgreSQL (Postgres) is an open source object-relational database known for reliability and data integrity.
- RavenDB: RavenDB is an open-source, transactionally consistent document database that stores application data in flexible records, helping developer…
- Redis: Redis is a fast, in-memory data structure store that can be used as a database, cache, and message broker.
- Valkey: Valkey is an open-source, high-performance in-memory key-value datastore forked from Redis.
- mariadb: MariaDB is a fast, open-source relational database server forked from MySQL by its original developers.

---
Source: Our Local Host (https://ourlocalhost.com/app/7192/couchdb), the self-hosted and open-source app directory.