DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk9 min

How to Install CouchDB and Fauxton on a Linux VPS

Install CouchDB on a supported Debian or Ubuntu VPS, configure the required administrator and single-node databases in Fauxton, and secure remote access with localhost binding, SSH tunneling, or an HTTPS reverse proxy.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install CouchDB from Apache’s signed Debian repository, create the required administrator account, initialize a single-node server in Fauxton, and keep port 5984 private unless a reverse proxy is deliberately configured. Fauxton is included with CouchDB 2.0 and later, so a separate UI package is normally unnecessary.

What you will have when the installation is complete

Apache CouchDB is an HTTP database server. Its administration interface, Fauxton, is served by CouchDB itself rather than by a separate daemon. On a normal VPS installation you will therefore have one service listening on CouchDB’s HTTP port, 5984, and you will manage it through URLs such as http://127.0.0.1:5984/_utils/index.html.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A single-node deployment is appropriate for a standalone VPS. The setup wizard creates CouchDB’s system databases, including _users, _replicator, and _global_changes. Applications can use the same HTTP API directly, while Fauxton is useful for first-run administration, configuration, document work, and replication controls.

The safe default is to bind CouchDB to 127.0.0.1. That makes the API and Fauxton reachable only from the VPS. If users or applications must connect over the network, put nginx or HAProxy in front of CouchDB, terminate HTTPS there, and firewall the backend port.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Supported Linux releases and prerequisites

Apache’s convenience packages cover Debian 11 (bullseye), Debian 12 (bookworm), Ubuntu 22.04 (jammy), Ubuntu 24.04 (noble), and supported RHEL/CentOS releases. The commands below are the documented Debian/Ubuntu path. Use a root-capable account with sudo, a working DNS and HTTPS connection, and enough disk space for the database files and logs.

  • Confirm the VPS is running one of the supported Debian or Ubuntu codenames.
  • Apply existing operating-system updates according to your normal maintenance policy.
  • Decide whether CouchDB is localhost-only, reachable on a private LAN, or published through a reverse proxy. Make this decision before choosing the bind address in the installer.
  • Prepare a long, unique CouchDB administrator password. CouchDB 3.0 and later will not run without an administrator account.

Install CouchDB from Apache’s signed repository

Using Apache’s repository gives you the package intended for your distribution rather than an unverified third-party build. Run the following commands as written on Debian or Ubuntu:

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
sudo apt update && sudo apt install -y curl apt-transport-https gnupg
curl https://couchdb.apache.org/repo/keys.asc | gpg --dearmor | sudo tee /usr/share/keyrings/couchdb-archive-keyring.gpg >/dev/null 2>&1
source /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg] https://apache.jfrog.io/artifactory/couchdb-deb/ ${VERSION_CODENAME} main" 
  | sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null
sudo apt update
sudo apt install -y couchdb

The source /etc/os-release line supplies the operating system’s codename, so the repository entry automatically uses bullseye, bookworm, jammy, or noble where applicable. If that variable is empty or does not match a supported release, stop and correct the operating-system identification before installing.

Answer the package configuration prompts

The Debian package asks whether the server is standalone or clustered, which address CouchDB should bind to, and for an administrator password. For one VPS, select the standalone or single-node choice. Enter the administrator credentials during this step. If you postpone that step, create the administrator in CouchDB’s configuration before attempting to start the service; CouchDB 3.x deliberately refuses to run without one.

Choose 127.0.0.1 for a private installation. Select a private interface only when another trusted machine must reach CouchDB directly. A public interface exposes both the API and Fauxton and should be used only with firewall rules and a reverse-proxy design.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Start CouchDB and verify the local endpoint

After installation, start the service with the service manager provided by your distribution package. On a systemd-based Debian or Ubuntu VPS, the usual command is:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
sudo systemctl enable --now couchdb
sudo systemctl status couchdb

The status command should show an active service. If it fails, inspect the service journal and correct the configuration or administrator-account problem before exposing any network port.

Test the local HTTP endpoint from the VPS itself:

curl http://127.0.0.1:5984/

Then open the first-run interface in a browser on the VPS, or through a secure tunnel:

Port 5984 is the local HTTP endpoint used in the official examples. Do not open it to the entire internet merely to make Fauxton convenient; a localhost bind plus an SSH tunnel keeps the database off the public network.

ssh -L 5984:127.0.0.1:5984 your-vps-user@your-vps-host

With that tunnel active, browse to the same 127.0.0.1:5984 URLs on your own computer. The browser connection terminates at the tunnel, while CouchDB remains bound locally on the VPS.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Complete the single-node setup in Fauxton

Fauxton is bundled with CouchDB 2.0 and later. You normally do not install an npm Fauxton package on a production VPS; npm is an optional development or UI-upgrade route. Open the setup wizard at:

http://127.0.0.1:5984/_utils#setup
  1. Choose Single-Node-Setup. This selects the one-server topology rather than the cluster workflow.
  2. Set the administrator username and password. Use the credentials created during package configuration or replace them with the account you intend to operate.
  3. Select the bind address. Keep 127.0.0.1 for a VPS administered locally or through an SSH tunnel. Choose a private interface only if a controlled network client requires direct access.
  4. Apply the configuration. The wizard creates the _users, _replicator, and _global_changes system databases needed for normal single-node operation.
  5. Return to Fauxton’s verification view. Confirm that the server responds and that you can authenticate with the administrator account before creating application databases.

If you configure CouchDB by file instead of using the wizard, setting [couchdb] single_node=true causes those system databases to be created on restart. The official documentation also describes manual curl -X PUT creation; use that route only when you intentionally manage the configuration outside Fauxton.

Choose the right network exposure

Deployment choice Operational result When it fits
Bind to 127.0.0.1 Only processes on the VPS can reach CouchDB and Fauxton. Most single-VPS installations; administer through an SSH tunnel.
Bind to a private LAN address Clients on that network can reach the API and UI. Private application tiers or trusted internal administration.
Bind to a public address The API and Fauxton become internet-reachable unless a firewall blocks them. Only when a deliberate firewall and reverse-proxy policy exists.
Reverse proxy with nginx or HAProxy The proxy accepts client connections, can terminate TLS, and forwards requests to CouchDB. Public hostnames, HTTPS, and production load balancing.

A bind address is not an authentication policy. Even with an administrator account, leaving 5984 publicly reachable increases attack surface and makes accidental exposure of Fauxton more likely. Restrict the backend with the VPS firewall and let the proxy be the public entry point.

Publish CouchDB safely through nginx

For a public hostname, place nginx in front of CouchDB rather than forwarding the raw 5984 port. Apache CouchDB’s best-practices guidance recommends nginx or HAProxy and emphasizes forwarding the original host and client information. When TLS ends at nginx, CouchDB also needs the original scheme so redirects and generated links use HTTPS.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A minimal nginx server block has this shape, assuming CouchDB listens locally and nginx owns the public hostname:

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.
server {
    listen 443 ssl;
    server_name couchdb.example.net;

    # Configure your certificate and key here.
    ssl_certificate     /etc/ssl/couchdb.example.net/fullchain.pem;
    ssl_certificate_key /etc/ssl/couchdb.example.net/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:5984;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

The hostname and certificate paths in this example are illustrative; use the names and certificate files issued for your own domain. Keep the backend bind address at localhost when nginx runs on the same VPS. If the proxy is on another host, bind CouchDB to a private interface and permit only that proxy’s private address in the firewall.

Check the proxy before changing DNS

  1. Validate nginx’s configuration with its distribution-provided test command.
  2. Reload nginx without stopping the existing listener.
  3. Request the public HTTPS hostname and verify that Fauxton loads and that an authenticated API request reaches CouchDB.
  4. Confirm that direct access to http://public-vps-address:5984 is blocked by the firewall or unavailable because CouchDB is bound only to localhost.

Do not remove the Host, X-Forwarded-For, or X-Forwarded-Proto headers. Dropping them can produce incorrect redirects, hide the client address from logs, or make CouchDB believe a secure request arrived over plain HTTP.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Single node or cluster?

The standalone wizard is the correct starting point for one VPS. A production cluster is a different topology: it uses multiple CouchDB nodes, a reverse proxy for load balancing and SSL termination, and coordinated firewall and authentication policies.

The cluster wizard is also reached through Fauxton at /_utils#setup. After configuring the nodes, query /_membership to verify that the expected nodes and the connected nodes match. A mismatch indicates that the cluster does not have the membership you intended and should be corrected before routing application traffic through it.

Do not select cluster mode simply because the VPS is powerful enough to run several processes. Clustering adds node discovery, proxy routing, and operational failure cases that a single-node installation does not have.

Package installation versus source or npm UI installation

Approach What the documented path provides Practical use
Apache Debian package Signed repository, distribution integration, package configuration prompts, and the CouchDB service. Recommended path for supported Debian and Ubuntu VPS releases.
Source installation Build and configuration responsibilities remain with the administrator. Specialized environments that require a non-package build.
Built-in Fauxton Fauxton is included in CouchDB 2.0 and later and is served at /_utils/. Normal production administration and verification.
npm-installed Fauxton An optional development or UI-upgrade route rather than a separate requirement for a VPS. Development work or an intentional UI customization.

The official material does not publish installation-time, memory, throughput, or latency benchmarks for these choices. Select based on supportability and network design, not on an assumed performance number.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshoot the common failure points

The package refuses to start

First check whether an administrator account exists. CouchDB 3.0 and later will not run without one. Re-enter the package configuration or create the account in the configuration files before restarting the service. Then inspect the service status and journal for the specific configuration error.

The repository command uses the wrong distribution

Print the value loaded from /etc/os-release and compare it with the supported codenames. A repository entry for the wrong codename can leave apt without a compatible CouchDB package. Correct the entry, run sudo apt update, and retry the installation.

Fauxton works on the VPS but not from your laptop

This is expected when CouchDB is bound to localhost. Use the SSH tunnel shown above, or publish it through nginx/HAProxy with HTTPS. Do not solve the symptom by opening 5984 to every source address.

The browser shows redirect or scheme problems behind nginx

Check that nginx forwards the original Host and X-Forwarded-Proto values and that the proxy is actually terminating TLS for the hostname you are using. Also verify that nginx can reach the backend address and port selected in CouchDB’s bind configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The setup wizard does not show the expected single-node result

Confirm that you selected Single-Node-Setup and applied the configuration. A file-based setup must include [couchdb] single_node=true before restart. The system databases should then exist; if they do not, revisit the configuration and service logs rather than creating application databases first.

A cluster reports unexpected membership

Query /_membership and compare the expected and connected node lists. Check private-address reachability, node configuration, and reverse-proxy routing before allowing application traffic to depend on the cluster.

Installation checklist

  • Use a supported Debian or Ubuntu release and Apache’s signed repository.
  • Install the prerequisites, import the signing key, add the codename-specific repository, and install couchdb.
  • Create the administrator before starting CouchDB.
  • Start the service and verify the local endpoint on port 5984.
  • Use the included Fauxton at /_utils/; do not install a separate UI for a normal production setup.
  • Run the Single-Node-Setup wizard and confirm the system databases were created.
  • Keep the bind address at 127.0.0.1 unless a private-network or public design requires otherwise.
  • For public access, use nginx or HAProxy, HTTPS, preserved forwarding headers, and firewall rules that protect the backend port.
  • For a cluster, verify membership through /_membership and use a reverse proxy for load balancing and SSL termination.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.