= Bonita Studio installation
:description: The first step of to getting started  is to set up your development environment.To do this, install Bonita Studio.

The first step of to getting started  is to set up your development environment.To do this, install Bonita Studio.

[NOTE]
====
If you have any problems while working through this tutorial, you can https://community.bonitasoft.com/questions-and-answers[ask for help on the Bonita community] and/or open an issue on the Bonita https://bonita.atlassian.net/projects/BBPMC/issues[Community issue tracker].
====

== Download Bonita Studio

To download the latest version of Bonita Studio, open the https://www.bonitasoft.com/downloads[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. {bonitaVersion}):

* Windows: `BonitaStudioCommunity-x.y-x86_64.exe`
* macOS: `BonitaStudioCommunity-x.y-x86_64.dmg`
* Linux: `BonitaStudioCommunity-x.y-x86_64.run`

You are now ready to start the installation process.

== Install Bonita Studio

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

The installer will guide you through a very basic installation configuration:

. Select installation language: this will be used for the installation process
. Welcome message: click on *Next*
. License agreement: you need to accept this to continue
. Installation directory: the default should be fine
. Confirmation that installation is about to start: click on "Next"
. Actual installation: wait a little bit
. You'll see a confirmation message that offers the option to start Bonita Studio. Choose to start Bonita Studio and click on *Finish*
. A "thank you for downloading" page will be displayed in your web browser. You can close it

image:images/getting-started-tutorial/installation/studio-installation-installer-08-last-screen.png[Bonita Studio installer last screen]

Bonita Studio is now installed. The default installation folders are:

* Windows: `C:\BonitaStudioCommunity-x.y`
* macOS: `/Applications/BonitaStudioCommunity-x.y`
* Linux: `/home/<username>/BonitaStudioCommunity-x.y`

== First Bonita Studio execution

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.

You should get the Bonita Studio welcome page:

image:images/getting-started-tutorial/installation/studio-first-start-02-studio-on-welcome-page.png[Bonita Studio with welcome page displayed]

[NOTE]
====
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 might take a while and some features may not be immediately available. A pop-up window will appear to indicate you can update the Bonita server configuration in xref:bonita-bpm-studio-preferences.adoc[preferences] image:images/getting-started-tutorial/installation/studio-first-start-03-starting-bonita-server-popup.png[Bonita Studio Server starting pop-up]
====

When the Bonita Engine is started, you will see a confirmation pop-up on your Bonita Studio welcome page.

image:images/getting-started-tutorial/installation/studio-first-start-04-engine-started-popup.png[Bonita Studio server started pop-up]

== Installation validation

To make sure that everything is properly installed, click on the *Portal* button image:images/getting-started-tutorial/installation/portal-icon.png[Bonita Portal icon] in the toolbar. This should open the Bonita Portal home page in your web browser:

image:images/getting-started-tutorial/installation/web-browser-display-portal.png[Bonita Portal display in a web browser]

Also click on the *UI Designer* button image:images/getting-started-tutorial/installation/ui-designer-icon.png[UI Designer icon] in the toolbar. This will display a pop-up window that you can ignore:

image:images/getting-started-tutorial/installation/ui-designer-launch-pop-up.png[UI Designer first launch pop-up window]

And the UI Designer should open in your web browser:

image:images/getting-started-tutorial/installation/ui-designer-first-start.png[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.
You are ready to move to the next chapter to xref:draw-bpmn-diagram.adoc[start creating your first process].
