Knowledge Base - Installation



Knowledge Base

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.

Terminal server

Bubble is also compatible for terminal server environments. Make sure the terminal server environment meets the system requirements. Only one Bubble process has access to the user folder. So depending on the terminal server configuration, in some situation you will have to make sure that each hotdesk workstation has its own user folder defined. See this knowledge base article.

macOS

Keep in mind that during the installation procedure you must activate disk access for the installer.Gy+6YxQsZX2tAAAAAElFTkSuQmCC


Or when installing, the installer asks for premissions in de folder the installer is located in. Click on "OK".

 Rgg9ZYojelWvKlmURUzQQc9FFgC+ww1if577Yjf3IwrZ3dQ9T9Jih0MzaYPsjxueZiMnIxsYBRVwjtsZRTZ31v+miAYdSytQuLP3r2uJYOn4AIh2+YRwy2uOH26PocrFrKF299Cv23gEImW0hp7NAQW2SAZ4jdNQsghtYaLHg2XWnj+xiKzFwZ3ruqVOpmeLn+QtX0i9+dSb9f9qeCYY9kpHeAAAAAElFTkSuQmCC

When a Bubble update is available, it can be installed in 3 ways:Update through installation via MSIUpdate through Bubble updaterUpdate as manual action in the softwareUpdate via the webportalFor an u...
The Bubble user profile is saved by default in the folder:%APPDATA%\Bubble. This location can be changed via the configuration parameters in the config.ini.Creating this config file is explained in th...
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...
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...

Creating a config.ini

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 (As Administrator) and add the parameters you want to use (see screenshot below). Note, always start with ‘ [bubble] ‘.

W8j0ODjTAoQQlKUILyBxDti7BsL+Qa4f8BY18aAURTWMkAAAAASUVORK5CYII=

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

h9dIfPXERlHZwAAAABJRU5ErkJggg==

Then Save in one of the listed locations, depending if you want to change settings system wide or user specific.

When Bubble starts, it tries to load the config.ini from the following locations:

  1. Installation directory / config.ini
    Windows: C:\Program Files\Bubble\config.ini
    MacOS: /Applications/Bubble.app/Contents/MacOS/config.ini
User profile folder
Windows: %APPDATA%/Bubble/config.ini
MacOS: /Users/{Username}/Library/Application Support/Bubble/config.ini


Available Parameters

Section Parameter Allowed Values Default Value Description bubble no_auto_start true / false false If true, Bubble will not startup automatically. bubble
no_update_check
true / false false If true, Bubble will skip the update check. bubble
user_folder
File path %APPDATA%/Bubble If set, Bubble will load user profile from a different location. bubble multi_tenant true / false false Enable multi-tenant, allow more than one user to login in the same application. proxyipIP address
Proxy IP addressproxyportPort number
Proxy port numberproxyusername

Proxy usernameproxypassword

Proxy password



From Bubble v3.3.0 and higher, there is an updater utility 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. -s, --start Start application after update (Windows only).
-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 of MSI in interactive mode

 Updater.exe -v latest -c stable

Get specific version and start installation of MSI in interactive mode

Updater.exe -v 3.0.0

Automatically check for new stable versions and start installation of MSI in passive mode (run task as administrator)

Updater.exe -a