Skip to content

Anonymous access

Anonymous access in CloudBeaver lets users connect to databases without authentication. Before configuring any anonymous connections, you must first enable anonymous access in the server settings.

Enabling anonymous access

You can turn on anonymous access in two ways: through the UI or by using server configuration.

Use the web UI

  1. Sign in as an administrator.
  2. Go to Administration -> Settings -> Server configuration.
  3. Select the Allow anonymous access checkbox.
  4. Click Save to apply the changes.

Use server configuration

Set the CLOUDBEAVER_APP_ANONYMOUS_ACCESS_ENABLED environment variable and restart the server.

Info

For details on where to define server parameters and how configuration files work, see Server configuration

Once anonymous access is enabled, you can set it up in one of two ways:

  • Administrator defined connections: Administrators can configure connections that are accessible anonymously, allowing access to these predefined connections.
  • Private connections: When enabled, this feature lets anonymous users configure their private connections from the main page. These connections are temporary and expire with the session.

Configuration methods

Enabling private connections for anonymous users

  1. As an administrator, navigate to the Settings -> Server configuration.

  2. Locate the Enable private connections option and activate this setting to allow the creation of connections by anonymous users.

  3. Save changes.

Administrator defined anonymous access

  1. Start the process of editing a connection as an administrator. For detailed instructions, refer to the Create Connection article.

  2. Navigate to the Access tab within the connection settings and click on the Edit button to modify access settings.

  3. Select the user entry (representing all users, including anonymous) by checking the box next to it, then click Grant to assign access.

    Tip

    If you want anonymous users to have a different default role, change the anonymousUserRole value in your server configuration.

  4. When you’ve finished configuring the connection, click Save to apply the changes.

Anonymous access limits

CloudBeaver Enterprise restricts the number of simultaneous anonymous sessions to prevent license overuse. The system applies the following rules:

  • The allowed number of anonymous sessions is calculated as Anonymous limit = Total licensed users - Currently logged-in users.
  • If all licensed users are logged in, anonymous mode is disabled automatically.
  • Each anonymous session ends automatically after 30 minutes of inactivity.
  • When the limit is exceeded, an error appears in the login window, and the event is recorded in the server log.