Installation

Bubble can be installed as an MSI installation file. See for this Partner Portal> Software on this knowledge base. The installation file is digitally signed by Red Cactus. This verifies that the file and content are from Red Cactus and no changes have been made to the code. In addition, the installation file will be automatically allowed by the Microsoft SmartScreen.

When a Bubble update is available, it can be installed in 3 ways:

  1. Update through installation via MSI
  2. Update through Bubble updater
  3. Update as manual action in the software

For an update via option 1, you can download a new version yourself from the Bubble Web Portal and install it over the old installation. The old installation is automatically removed and the user profile is preserved.

An update via option 2 can be chosen as soon as a new update is available. When Bubble starts up, it checks for a new update. If this is the case, a popup will be shown. The installation can be started by clicking on the pop-up. For more information about option 3 see Software > Application on the knowledge base.

Disable updates

It is possible to disable updates for users. This can be done via the partner portal (see partner portal > settings ) or with a configuration parameter.

Config.ini Executable parameter Explanation Available from version
no_update_check=true -no_update-check Application should not check for new update available 1.3.0

The user profile is saved by default in the folder:%APPDATA%\Bubble . This location can be adjusted via the configuration parameters.

Config.ini Executable parameter Explanation Available from version
user_folder=D:\Bubble_user_data\
u|--user_folder=D:\Bubble_user_Data\
When the user data should be saved in a folder other than %APPDATA% \Bubble. 1.7.3

Bubble will be started automatically every time the system starts. A shortcut will be placed to Bubble in the folder%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\Startup . If you do not want this, you can change this via the configuration parameters.

Config.ini Executable parameter Explanation Available from version
no_auto_start=true
Application will not start when started with -auto_start argument. 1.7.4
-auto_start
Argument is passed to application when it is started automatically when the user logs into Windows. 1.7.4

It is possible to create a multi-tenant version of Bubble so that you can have multiple users active at the same time. This can be useful for a number of CRM- ERP- applications. For example, you can install Bubble on a server instead of on the user’s PC. Via the configuration parameters you can make Bubble multi-tenant.

Config.ini Executable parameter Explanation Available from version
multi_tenant=true
-multi_tenant
Makes the application multi-tenant. 2.0.15

Bubble software

If Bubble has been made multi-tenant, an extra button will be visible at the top. To register some users you can click on the plus or first on the hamburger icon and then on Add Instance.

Bulk Login

If you want to register many users at the same time, you can use bulk registration. Click on the hamburger icon and the screen will appear as shown below. Click on import and import the file created in the partner portal (see explanation of multi-tenant OTPs below).

Multi-tenant OTPs

To generate a file with usernames and passwords, you can use the Multi-tenant OTPs function. Go to the partner portal and open the correct customer. Then go to the tab bubble> Multi-tenant OTPs . Select the users and click Export . You can use the generated file for the bulk logins as described above. Please note, the created file is only valid for 2 hours. If you do not upload the export in Bubble within 2 hours, you must perform this procedure again.

In this knowledge base we mention that you can adjust various settings through a config.ini file. Creating a config.ini file is very simple. Open notepad and add the parameters you want to use (see screenshot below). Note, always start with ‘ [bubble] ‘.

Then click File> Save as> and name the file config.ini

After that, the file will look like this:

Windows

As a final step, you need to drag this file into the Bubble installation folder. You can find these via Explorer> Windows (C:)> Program Files> bubble

macOS

As a final step, you need to drag this file into the Bubble profile folder. You can find these via /Users/{Username}/Library/Application Support/Bubble

From Bubble v3.3.0 and higher, there is an updater functionality in Bubble’s installation folder. It’s called “Updater.exe” (or Updater on OSX).

C:\Program Files\Bubble>updater.exe –help

-v, –version=VALUE Target version, e.g. ‘latest’ or v3.0.0

-c, –channel=VALUE Update channel, e.g. ‘stable’ or ‘beta’

-a, –auto Automatic update.

-h, –help Print help menu.

An update can be performed here manually (or automatically) via a task. Some examples:

Get the latest stable version and start installation interactively

Updater.exe -v latest -c stable

Get specific version and start installation interactively

Updater.exe -v 3.0.0

Automatically check for new stable versions and start installation passively (run task as administrator)

Updater.exe -a