Adding a ReportBurster Connection to CloudBeaver

Step-by-step guide to connect CloudBeaver to your databases

Setup Steps

Follow these steps to add your ReportBurster database connection

1
Start CloudBeaver
Launch CloudBeaver by running the command:
service app start cloudbeaver 8978
2
Open CloudBeaver
Navigate to http://localhost:8978 in your browser.
3
First-time setup
On first launch, CloudBeaver shows a setup wizard. Set an admin password, then click “Finish” to complete the initial configuration.
4
New Connection
Click the + icon in the top toolbar → select PostgreSQL from the list of available drivers.
5
Enter connection values
Fill in the connection form using the values from ReportBurster’s connection config:
Field Value
Host host.docker.internal
Port 5432
Database Northwind
Username postgres
Password postgres
6
Test Connection
Click the “Test Connection” button. You should see a “Connection successful” message.
7
Save
Click “Save” — the connection now appears in the navigator panel on the left.

⚠ Important: Use host.docker.internal instead of localhost

CloudBeaver runs inside a Docker container. When you type localhost in the connection settings, it refers to the container itself — not your host machine. Use host.docker.internal instead, which is a special DNS name that Docker resolves to your host machine where the databases actually run.

Fallback: Direct Config Editing

Alternative approach if the UI wizard doesn't work

Athena can configure CloudBeaver directly

If the CloudBeaver UI doesn’t work for adding a connection, Athena can modify CloudBeaver’s configuration files directly at:

_apps/cloudbeaver/workspace/.data/.dbeaver/data-sources.json

After editing, Athena will ask you to restart CloudBeaver so the changes take effect.