This documentation is for a version that is out of support.

You may want to view the same page for the latest version, or for any of the versions available in the drop-down menu in the top-right corner.

Bonita Studio installation

This page describes how to download and install Bonita Studio on Windows, Linux, or Mac operating systems.

Bonita Studio download

Prerequisites

Check the hardware and software requirements.

MacOs specific prerequisites

For users of macOS Big Sur 11.0 and above: Only version 7.11.4 and upwards are compatible

Only installed JDK are accepted by the macOS gatekeeper.
If you try to use a JDK directly downloaded, you will get this kind of error: jdk-11.0.5 can’t be opened because it is from an unidentified developer.
The solution is to use an installer to install properly the JDK. The easiest way is to tape the following commands:

# Install brew first if it is not installed yet, more details here: https://brew.sh
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# Use brew to install a JDK
brew tap homebrew/cask-versions
brew cask install java11

Another solution is to download and execute manually the installer, here for example.

Windows specific note

The security feature called SmartScreen prevents execution of Bonita Studio installer. When you get the "Windows protect your PC" pop up window, click on "More info" link and click on "Run anyway" button.

Community edition

To download the latest version of Bonita Studio Community edition, open the download page and click on the Download button. This will start the download of the Bonita Studio installer for your operating system.

When the download is finished, you should have one of the following files on your computer (x.y refers to the version of Bonita Studio, e.g. 2021.2):

  • Windows: BonitaStudioCommunity-x.y-x86_64.exe

  • macOS: BonitaStudioCommunity-x.y-x86_64.dmg

  • Linux: BonitaStudioCommunity-x.y-x86_64.run

Subscription edition

Subcription editions cover the now unique Enterprise editions, but also the Performance, Efficiency, and Teamwork editions that are no longer sold but still supported at Bonitasoft.
To download the latest version of Bonita Studio Subscription edition, go to the Customer Service Center and request the download of the version you need.

When the download is complete, you have one of the following new files:

  • Windows: BonitaSubscription-x.y.z-x86_64.exe

  • macOS: BonitaSubscription-x.y.z-macOs.dmg

  • Linux: BonitaSubscription-x.y.z-x86_64.run

  • Zip, no Installer (Windows or Linux): BonitaStudioSubscription-x.y.z.zip

You are now ready to start the installation process.

Bonita Studio installation

Installation using a wizard

To run the installer for Windows, macOS or Linux, double-click on the file you downloaded.

Then follow the installation wizard through to the end of the installation procedure:

  1. Select installation language: this will be used for the installation process

  2. Welcome message: click on Next

  3. License agreement: you need to accept this to continue

  4. Installation directory: make sure the path is quite short and the directory is empty The default installation directories are:

    • Windows: C:\BonitaStudioCommunity-x.y

    • macOS: /Applications/BonitaStudioCommunity-x.y

    • Linux: /home/<username>/BonitaStudioCommunity-x.y

  5. Confirmation that installation is about to start: click on "Next"

  6. Actual installation: wait a little bit

  7. License request. For the Subscription edition only. If you do not have your licence file ready, you can skip that; Bonita Studio will request the license at first start.

  8. You’ll see a confirmation message that offers the option to start Bonita Studio. Choose to launch Bonita Studio and click on Finish

  9. A "thank you for downloading" page will be displayed in your web browser, with important getting starting information.

License

This information applies to the Subscription editions. No license is needed for the Community edition.

When you install or launch Bonita Studio for the first time, you need to install a license:

  1. From the installer, click Copy to clipboard to copy the request key generated specifically for your Bonita Studio

  2. Go to the Customer Service Center and request a license using the request key in the clipboard

  3. Wait a few seconds to get the file from the license page, or check your email box (after a few minutes) and open the email from no-reply@bonitasoft.com

  4. Download the license file (.lic)

  5. Go back to your Bonita Studio, click Install license…​, and select your .lic file.

Installation using Zip archive (Windows or Linux)

To install Bonita Studio using the Zip archive, unzip the downloaded .zip file to a folder on your hard drive.
Avoid using a folder with a long path. Do not use a path that contains spaces.

Bonita Studio is now installed.

First Bonita Studio execution

To start Bonita Studio, go to the directory where you installed it, and run the launcher for your operating system.

Community edition

  • Windows: BonitaStudioCommunity.exe

  • macOS: BonitaStudioCommunity.app

  • Linux: BonitaStudioCommunity-linux

Subscription edition

  • Windows: BonitaStudioSubscription.exe

  • macOS: BonitaStudioSubscription.app

  • Linux: BonitaStudioSubscription-linux

Now Bonita Studio should be running on your computer.
If not, you can manually start it by using the installed shortcut or by using the Bonita Studio executable file from the installation folder.

When Bonita Studio starts, various tasks are executed in the background, such as the embedded Bonita test server startup (including Bonita Engine initialization), Bonita test organization deployment, and more. This behavior can be configured in the preferences.
This might take a while and some features may not be immediately available.
When those operations are completed, a notification pops up on your Bonita Studio welcome page.

Installation validation

To make sure that everything is properly installed, click on the Applications button in the toolbar. This should open the Bonita Application Directory in your web browser:

Bonita Application display in a web browser

Also click on the UI Designer button in the toolbar to check that the UI Designer is ready to use:

UI Designer on first launch displayed in a web browser

Ready to move on

You have successfully installed Bonita Studio, and the tools and test environment are up and running.