Skip to content

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.

Info

Refer to the official Nginx documentation.

  1. 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](Server-configuration.md#application-parameters).

  1. Apply the changes:

  2. Reload the Nginx configuration.

  3. Open CloudBeaver in your browser using http://127.0.0.1.