| --- |
| title: Launching |
| title_in_menu: Launching |
| layout: website-normal |
| menu_parent: index.md |
| --- |
| |
| This guide will walk you through connecting to the Brooklyn Server Graphical User Interface and performing various tasks. |
| |
| For an explanation of common Brooklyn Concepts see the [Brooklyn Concepts Quickstart](/guide/start/concept-quickstart.md) or see the full guide in the [Brooklyn Concepts](/guide/concepts) chapter of the [User Guide](/guide). |
| |
| This guide assumes that you are using Linux or Mac OS X and that Brooklyn Server will be running on your local system. |
| |
| ## Launch Apache Brooklyn |
| |
| If you haven't already done so, you will need to start Brooklyn Server using the commands shown below. |
| It is not necessary at this time, but depending on what you are going to do, |
| you may wish to set up some other configuration options first, |
| |
| * [Security](/guide/ops/configuration/brooklyn_cfg.md) |
| * [Persistence](/guide/ops/persistence) |
| |
| Now start Brooklyn with the following command: |
| |
| {% highlight bash %} |
| $ cd apache-brooklyn-{{ site.brooklyn.version }} |
| $ bin/brooklyn launch |
| {% endhighlight %} |
| |
| Please refer to the [Server CLI Reference](/guide/ops/server-cli-reference.md) for details of other possible command line options. |
| |
| Brooklyn will output the address of the management interface: |
| |
| ``` |
| INFO Starting Brooklyn web-console with no security options (defaulting to no authentication), on bind address <any> |
| INFO Started Brooklyn console at http://127.0.0.1:8081/, running classpath://brooklyn.war@ |
| INFO Persistence disabled |
| INFO High availability disabled |
| INFO Launched Brooklyn; will now block until shutdown command received via GUI/API (recommended) or process interrupt. |
| ``` |
| |
| _Notice! Before launching Apache Brooklyn, please check the `date` on the local machine. |
| Even several minutes before or after the actual time could cause problems._ |
| |
| ## Connect with Browser |
| |
| Next, open the web console on [http://127.0.0.1:8081](http://127.0.0.1:8081). |
| No applications have been deployed yet, so the "Create Application" dialog opens automatically. |
| |
| [](images/add-application-catalog-web-cluster-with-db-location-large.png) |
| |
| |
| ## Next |
| The next section will show how to **[deploy a blueprint](blueprints.md)**. |
