> For the complete documentation index, see [llms.txt](https://docs.sonarsource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonarsource.com/sonarqube-community-build/try-out-sonarqube.md).

# Try out SonarQube Community Build

You’ve heard about how [SonarQube](https://www.sonarsource.com/products/sonarqube/) can help you write high quality, safer code, and now you’re ready to try it out for yourself. This guide shows you how to install a local instance of SonarQube Community Build and analyze a project. Installing a local instance gets you up and running quickly, so you can experience SonarQube Community Build firsthand.

You can download [SonarQube Community Build](https://www.sonarsource.com/products/sonarqube/). Or try [Developer Edition](https://www.sonarsource.com/plans-and-pricing/developer/) or [Enterprise Edition](https://www.sonarsource.com/plans-and-pricing/enterprise/) for free for 14 days.

Once you’re ready to set up a production instance, review the [Introduction](/sonarqube-community-build/server-installation/introduction.md) documentation on installing community build.

## Installing a local instance of SonarQube Community Build <a href="#installing-a-local-instance-of-sonarqube" id="installing-a-local-instance-of-sonarqube"></a>

To get started quickly, we recommend evaluating SonarQube Community Build by spinning up a [Docker container](https://hub.docker.com/_/sonarqube/). Alternatively, an installation using a [zip file](https://www.sonarsource.com/products/sonarqube/downloads/) is also available.

### From the Docker image

Find the SonarQube Community Build Docker image on [Docker hub](https://hub.docker.com/_/sonarqube/). Start the server by running:

```css-79elbk
$ docker run -d --name sonarqube -e SONAR_ES_BOOTSTRAP_CHECKS_DISABLE=true -p 9000:9000 sonarqube:latest
```

Once your instance is up and running, log in to `http://localhost:9000` using System Administrator credentials:

* login: admin
* password: admin

You will be asked to change your password.

### Zip file alternative

To install from the zip file, use the following instructions:

<details>

<summary>From the zip file</summary>

1. Download and install [Java 17](https://adoptium.net/en-GB/temurin/releases/?version=17) or [Java 21](https://adoptium.net/en-GB/temurin/releases/?version=21).
2. [Download](https://www.sonarsource.com/products/sonarqube/downloads/) the SonarQube Developer Edition zip file.
3. As a **non-`root`** **user**, unzip it in, for example, `C:\sonarqube` or `/opt/sonarqube`.
4. As a **non-`root`** **user**, start the SonarQube Community Build:

```css-79elbk
# On Windows, execute:
C:\sonarqube\bin\windows-x86-64\StartSonar.bat
 
# On other operating systems, as a non-root user execute:
/opt/sonarqube/bin/<OS>/sonar.sh console
```

If your instance fails to start, check your [Server logs](/sonarqube-community-build/server-update-and-maintenance/troubleshooting/server-logs.md) to find the cause.

Once your instance is up and running, log in to `http://localhost:9000` using System Administrator credentials:

* login: admin
* password: admin

You will be asked to change your password.

</details>

## Analyzing a project <a href="#analyzing-a-project" id="analyzing-a-project"></a>

Now that you’re logged in to your local SonarQube Community Build instance, let’s analyze a project:

1. Select **Create new project**.
2. Give your project a **Project key** and a **Display name** and select **Set up**.
3. Under **Provide a token**, select **Generate a token**. Give your token a name, select **Generate**, and click **Continue**.
4. Select your project’s main language under **Run analysis on your project**, and follow the instructions to analyze your project. Here you’ll download and execute a scanner on your code (if you’re using Maven or Gradle, the scanner is automatically downloaded).

After successfully analyzing your code, you’ll see your first analysis on SonarQube Community Build:

<div align="left"><figure><img src="/files/VYuEHEdYCXqRFuxDYfXH" alt="Analysis of a project in Multi-Quality rule mode on SonarQube Community Build." width="563"><figcaption></figcaption></figure></div>

Your first analysis is a measure of your current code. As a developer, you focus on maintaining high standards and taking responsibility specifically for the new code you’re working on. From this point, you should focus on code that has been added or changed. See [Quality standards and new code](/sonarqube-community-build/user-guide/about-new-code.md) for more information.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-community-build/try-out-sonarqube.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
