How to Set Up Nginx as a Reverse Proxy for Couchbase

Setting up Nginx as a reverse proxy for Couchbase can be useful when you want to distribute the load across multiple Couchbase servers or when you need to access Couchbase from a location where direct connection is not possible. Here’s a step-by-step guide:

1. Install Nginx:

If Nginx is not already installed on your server, you can install it using your package manager. On Ubuntu, you can use:

sudo apt update
sudo apt install nginx

2. Install Couchbase:

Install Couchbase on your server by following the official Couchbase installation guide for your platform.

3. Configure Couchbase:

Set up Couchbase with the appropriate configurations for your use case. This includes setting up buckets, defining indexes, and configuring security.

4. Configure Nginx for Couchbase:

Create a new Nginx configuration file for Couchbase. You can create this file in the /etc/nginx/conf.d/ directory:

sudo nano /etc/nginx/conf.d/couchbase.conf

Add the following configuration:

upstream couchbase_backend {
    server 127.0.0.1:8091; # Address and port of your Couchbase server
}

server {
    listen 80;
    server_name couchbase.example.com; # Replace with your domain or server IP

    location / {
        proxy_pass http://couchbase_backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

• upstream couchbase_backend: Defines a group of Couchbase servers.
• server 127.0.0.1:8091: Specifies the address and port of your Couchbase server.
• location /: Handles requests to the Couchbase proxy.
• proxy_pass http://couchbase_backend;: Passes the request to the Couchbase server defined in the upstream block.
• proxy_set_header lines: Set necessary headers for proper request handling.

5. Test Nginx Configuration:

Before applying the changes, test your Nginx configuration:

sudo nginx -t

If the test is successful, you should see a message indicating that the configuration is okay.

6. Reload Nginx:

Reload Nginx to apply the new configuration:

sudo systemctl reload nginx

7. Access Couchbase via Nginx:

Now, you can access Couchbase via Nginx using the server name or IP address you configured in the Nginx reverse proxy.

For example, if you set up Nginx with the server name couchbase.example.com, you can access Couchbase by visiting:

http://couchbase.example.com/

Nginx will proxy requests to the Couchbase server.

By following these steps, you have set up Nginx as a reverse proxy for Couchbase, allowing you to control access and potentially distribute the load across multiple Couchbase servers.