CouchDB

NoSQL database oriented to JSON documents, with native replication and integrated HTTP API.

Version:

3.5.1

back to Marketplace

VM Requisites

Resource Minimum
CPU 2 vCPU
RAM 4 GB
Disk 40 GB
Operating System Ubuntu 22.04 / 24.04

Access Port

Port Protocol Usage
30594 HTTP CouchDB REST API and Web UI (Fauxton)

How To Access

API REST

CouchDB exposes an HTTP API directly. You can interact with it using curl or any HTTP client.

# Verify that CouchDB is responding
  curl http://<IP_DE_LA_VM>:30594/

# With authentication
    curl http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/

Expected answer:

{
  "couchdb": "Welcome",
  "version": "3.x.x",
  "features": ["access-ready", "reshard", "scheduler"],
  "vendor": { "name": "The Apache Software Foundation" }
}

UI Web — Fauxton

CouchDB includes a web interface for visually managing databases:

http://<IP_DE_LA_VM>:30594/_utils/

Log in with your username and password to manage databases, documents, and indexes from your browser.

Verify that CouchDB is active

# View the CouchDB pod
kubectl get pods -A | grep couchdb

# View installation log
tail -f /var/log/cuemby/bootstrap.log

# Verify that the port is listening
ss -tlnp | grep 30594

Configuration Parameters

Parameter Default Description
COUCHDB_PASSWORD ⚠️ auto-generated Administrator user password. If left blank, Cuemby generates a random one.
COUCHDB_USER admin Administrator username.
COUCHDB_DATA_SIZE 20Gi Persistent volume size for databases.

ℹ️ If you did not set a password during deployment, look for it in the deployment outputs in the Cuemby portal.

First Steps (quick start)

# Create a database
curl -X PUT http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/mi_database

# Insert a document
  curl -X POST http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/mi_database \
  -H "Content-Type: application/json" \
  -d '{"nombre": "ejemplo", "activo": true}'

# List databases
    curl http://<USUARIO>:<PASSWORD>@<IP_DE_LA_VM>:30594/_all_dbs

Quick Troubleshooting

Problem Probable cause Solution
Connection refused CouchDB still getting started Wait ~3–5 min and check tail -f /var/log/cuemby/bootstrap.log.
401 Unauthorized Incorrect credentials Review the deployment outputs in the Cuemby portal.
Fauxton is not loading Port 30594 not reachable Verify that the pod is in Running with kubectl get pods -A.
Pod in CrashLoopBackOff Insufficient disk space or RAM Check with kubectl describe pod -n .

Cuemby Cloud

IaaS

About Cuemby Cloud

Cuemby Cloud is enterprise-grade cloud infrastructure managed from a single console, built for stronger security, predictable operations, and easy scaling across regions.

Datacenters regions available in Colombia, Ecuador, and Chile

Backed by Tier III / Tier IV data center locations

Zero Network Ingress and Egress Fees

24/7 local expert support

Ready to Modernize Your Enterprise?

Future challenges demand future-ready solutions.
Let’s get started!

© Copyright | Cuemby® 2025