This page provides a practical baseline setup for CouchDB on Linux hosts. For production deployments, ensure you follow security best practices and review configuration guidelines.
# Update package index
sudo apt update
# Install CouchDB
sudo apt install -y couchdb
# During installation, you'll be prompted for configuration:
# - Bind address (typically 127.0.0.1 for single node, 0.0.0.0 for cluster)
# - Admin username and password
# - Single node vs. cluster setup
# Install CouchDB
sudo dnf install -y couchdb
# Or on older systems using yum
sudo yum install -y couchdb
sudo systemctl enable couchdb
sudo systemctl start couchdb
sudo systemctl status couchdb
# Check if service is running
curl -s http://127.0.0.1:5984/
# Expected response: {"couchdb":"Welcome","version":"x.x.x","features":[...],"vendor":{"name":"The Apache Software Foundation"}}
After installation, you should:
Set up admin credentials (if not done during installation):
# Access the CouchDB configuration
sudo nano /etc/couchdb/local.ini
# Add admin credentials in [admins] section
[admins]
admin = your_strong_password
Configure for production:
Check logs:
sudo journalctl -u couchdb -f