{"id":3005,"date":"2024-10-22T13:03:51","date_gmt":"2023-12-11T06:02:35","guid":{"rendered":""},"modified":"2025-08-09T16:16:29","modified_gmt":"2025-08-09T15:16:29","slug":"how-to-install-apache-couchdb-nosql-database-server-on-debian-11-2","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-apache-couchdb-nosql-database-server-on-debian-11-2\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Apache CouchDB NoSQL Database Server on Debian 11"},"content":{"rendered":"

 <\/p>\n

How to Install Apache CouchDB NoSQL Database on Windows VPS<\/h1>\n

By \u0141ukasz Bod\u017aiony<\/span>, CEO of NETCLOUD24.COM<\/a> | Windows VPS<\/a><\/p>\n

Apache CouchDB is a powerful NoSQL database designed for scalability and ease of use. This guide provides step-by-step instructions for installing CouchDB on various Linux distributions (Debian 11, Rocky Linux 8, Ubuntu, AlmaLinux 12, FreeBSD) using manual setup, Docker, Ansible, Kubernetes, and Terraform. Whether you’re a beginner or an advanced user, this tutorial will help you set up CouchDB efficiently.<\/p>\n

Why Choose CouchDB?<\/h2>\n

CouchDB offers a robust, JSON-based document store with a RESTful HTTP API, making it ideal for modern web applications. Its replication and offline capabilities ensure high availability, perfect for distributed systems.<\/p>\n

Manual Installation on Debian 11 \/ Ubuntu<\/h2>\n

Follow these steps to manually install CouchDB on Debian 11 or Ubuntu-based systems:<\/p>\n

\r\n# Update system packages\r\nsudo apt update && sudo apt upgrade -y\r\n\r\n# Install required dependencies\r\nsudo apt install -y curl gnupg\r\n\r\n# Add CouchDB repository\r\necho \"deb https:\/\/apache.bintray.com\/couchdb-deb bullseye main\" | sudo tee \/etc\/apt\/sources.list.d\/couchdb.list\r\ncurl -L https:\/\/couchdb.apache.org\/repo\/keys.asc | sudo apt-key add -\r\n\r\n# Install CouchDB\r\nsudo apt update\r\nsudo apt install -y couchdb\r\n    <\/code><\/pre>\n
After installation, configure CouchDB by editing \/opt\/couchdb\/etc\/local.ini<\/code> to set the admin user and password.<\/p>\n
Manual Installation on Rocky Linux 8 \/ AlmaLinux 12<\/h2>\n
For RPM-based distributions like Rocky Linux 8 or AlmaLinux 12:<\/p>\n
\r\n# Install EPEL repository\r\nsudo dnf install -y epel-release\r\n\r\n# Add CouchDB repository\r\nsudo dnf install -y https:\/\/couchdb.apache.org\/repo\/couchdb.rpm\r\n\r\n# Install CouchDB\r\nsudo dnf install -y couchdb\r\n    <\/code><\/pre>\n
Start and enable CouchDB:<\/p>\n
\r\nsudo systemctl start couchdb\r\nsudo systemctl enable couchdb\r\n    <\/code><\/pre>\n
Manual Installation on FreeBSD<\/h2>\n
For FreeBSD systems:<\/p>\n
\r\n# Update package database\r\nsudo pkg update\r\n\r\n# Install CouchDB\r\nsudo pkg install -y couchdb3\r\n\r\n# Enable and start CouchDB\r\nsudo sysrc couchdb_enable=\"YES\"\r\nsudo service couchdb start\r\n    <\/code><\/pre>\n
Using Docker<\/h2>\n
Docker simplifies CouchDB deployment across platforms:<\/p>\n
\r\n# Pull the official CouchDB image\r\ndocker pull apache\/couchdb:latest\r\n\r\n# Run CouchDB container\r\ndocker run -d -p 5984:5984 --name couchdb \\\r\n  -e COUCHDB_USER=admin \\\r\n  -e COUCHDB_PASSWORD=yourpassword \\\r\n  apache\/couchdb:latest\r\n    <\/code><\/pre>\n
Access CouchDB at http:\/\/localhost:5984\/_utils<\/code>.<\/p>\n
Using Ansible for Automated Deployment<\/h2>\n
Ansible automates CouchDB installation. Create a playbook (couchdb.yml<\/code>):<\/p>\n
\r\n---\r\n- hosts: all\r\n  become: yes\r\n  tasks:\r\n    - name: Add CouchDB repository\r\n      apt_repository:\r\n        repo: deb https:\/\/apache.bintray.com\/couchdb-deb bullseye main\r\n        state: present\r\n    - name: Install CouchDB\r\n      apt:\r\n        name: couchdb\r\n        state: present\r\n        update_cache: yes\r\n    - name: Ensure CouchDB is running\r\n      service:\r\n        name: couchdb\r\n        state: started\r\n        enabled: yes\r\n    <\/code><\/pre>\n
Run the playbook:<\/p>\n
\r\nansible-playbook couchdb.yml\r\n    <\/code><\/pre>\n
Using Kubernetes<\/h2>\n
Deploy CouchDB on Kubernetes with a deployment manifest (couchdb-deployment.yaml<\/code>):<\/p>\n
\r\napiVersion: apps\/v1\r\nkind: Deployment\r\nmetadata:\r\n  name: couchdb\r\nspec:\r\n  replicas: 1\r\n  selector:\r\n    matchLabels:\r\n      app: couchdb\r\n  template:\r\n    metadata:\r\n      labels:\r\n        app: couchdb\r\n    spec:\r\n      containers:\r\n      - name: couchdb\r\n        image: apache\/couchdb:latest\r\n        env:\r\n        - name: COUCHDB_USER\r\n          value: \"admin\"\r\n        - name: COUCHDB_PASSWORD\r\n          value: \"yourpassword\"\r\n        ports:\r\n        - containerPort: 5984\r\n---\r\napiVersion: v1\r\nkind: Service\r\nmetadata:\r\n  name: couchdb-service\r\nspec:\r\n  selector:\r\n    app: couchdb\r\n  ports:\r\n    - protocol: TCP\r\n      port: 5984\r\n      targetPort: 5984\r\n  type: ClusterIP\r\n    <\/code><\/pre>\n
Apply the manifest:<\/p>\n
\r\nkubectl apply -f couchdb-deployment.yaml\r\n    <\/code><\/pre>\n
Using Terraform<\/h2>\n
Deploy CouchDB on a VPS using Terraform (couchdb.tf<\/code>):<\/p>\n
\r\nprovider \"aws\" {\r\n  region = \"us-east-1\"\r\n}\r\n\r\nresource \"aws_instance\" \"couchdb\" {\r\n  ami           = \"ami-0c55b159cbfafe1f0\" # Replace with your preferred AMI\r\n  instance_type = \"t2.micro\"\r\n  user_data     = <<-EOF #!\/bin\/bash apt update apt install -y curl echo \"deb https:\/\/apache.bintray.com\/couchdb-deb bullseye main\" > \/etc\/apt\/sources.list.d\/couchdb.list\r\n                  curl -L https:\/\/couchdb.apache.org\/repo\/keys.asc | apt-key add -\r\n                  apt update\r\n                  apt install -y couchdb\r\n                  EOF\r\n  tags = {\r\n    Name = \"CouchDB-Server\"\r\n  }\r\n}\r\n    <\/code><\/pre>\n
Run Terraform:<\/p>\n
\r\nterraform init\r\nterraform apply\r\n    <\/code><\/pre>\n
Configuration<\/h2>\n
After installation, configure CouchDB by editing \/opt\/couchdb\/etc\/local.ini<\/code> (or equivalent). Set the admin credentials and bind address:<\/p>\n
\r\n[admins]\r\nadmin = yourpassword\r\n\r\n[chttpd]\r\nbind_address = 0.0.0.0\r\n    <\/code><\/pre>\n
Restart CouchDB after changes:<\/p>\n
\r\nsudo systemctl restart couchdb\r\n    <\/code><\/pre>\n
Promote Your VPS with NETCLOUD24.COM<\/h2>\n
\n
Looking for reliable VPS hosting to run your CouchDB server? NETCLOUD24.COM<\/a> offers high-performance Windows and Windows VPS solutions tailored to your needs. Explore our services in multiple regions:<\/p>\n