Proxy configuration
Overview
CloudBeaver includes a built-in reverse proxy for secure access and load balancing. You can choose between HAProxy and Nginx.
Info
CloudBeaver AWS uses the default pre-configured proxy setup as the Enterprise Edition. Community Edition users need to configure the proxy manually. Read more.
Configure proxy server
Note
This feature is available in Enterprise, AWS, Team editions only.
Starting in version 25.1
, CloudBeaver supports two proxy types: Nginx and HAProxy. Set the proxy type in
your .env
file:
If you previously used Nginx and want to switch to HAProxy, you can do it without losing configuration or SSL certificates - shared Docker volumes handle it.
Info
For details on environment configuration, see CloudBeaver Enterprise deployment from Docker Compose
Proxy ports
When using Docker Compose with network_mode: host
, set ports with:
These control which ports the proxy listens to inside the container.
Extra step for Nginx
If you use Nginx and set a custom COMPOSE_PROJECT_NAME
in your .env
, pass it explicitly in the containerās
environment
block:
Note
This isnāt needed for HAProxy - it resolves service names via Docker DNS.
Nginx configuration in CloudBeaver Community
In the Community Edition, you can configure Nginx manually to set up a web server in front of CloudBeaver.
If you prefer, you can configure HTTPS directly for the Jetty server. For details, see Jetty configuration.
-
Install Nginx on your server.
Info
Refer to the official Nginx documentation.
-
Add a proxy configuration:
- Open the main Nginx configuration file in a text editor.
- 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. -
Apply the changes:
- Reload the Nginx configuration.
- Open CloudBeaver in your browser using
http://127.0.0.1
.