CloudBeaver and Nginx

Table of contents

• Overview
• Nginx configuration

Overview

CloudBeaver works out of the box but uses plain HTTP, processes static content via Jetty. Adding a web server like Nginx improves security, performance, and scalability.

The Enterprise Edition provides pre-configured Nginx for seamless integration. Community Edition users can manually configure Nginx to enhance functionality.

Note: When deploying CloudBeaver AWS, the setup uses the same pre-configured Nginx settings as the Enterprise Edition.

Nginx configuration

In the Community Edition, you can configure Nginx manually to set up a web server in front of CloudBeaver.

Tip: If you prefer, you can configure HTTPS directly for the Jetty server. For details, see Jetty configuration.

1. Install Nginx on your server.

   Refer to the official Nginx documentation.

2. Add a proxy configuration:

   1. Open the main Nginx configuration file in a text editor.
   2. In your Nginx configuration file inside the http section, add the following:

         server {
            listen 80;
            server_name _;
            client_max_body_size 500M;
            location / {
               proxy_pass http://127.0.0.1:8978;
               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;
               proxy_http_version 1.1;
               proxy_set_header Upgrade $http_upgrade;
               proxy_set_header Connection "upgrade";
           }
       }

   To ensure the client’s real IP address is forwarded when using Nginx, add the forwardProxy:true parameter to your server configuration.

3. Apply the changes:

• Reload the Nginx configuration.
• Open CloudBeaver in your browser using http://127.0.0.1.