> For the complete documentation index, see [llms.txt](https://ecfmg.gitbook.io/sfdx-unlocked-packages-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ecfmg.gitbook.io/sfdx-unlocked-packages-guide/developer-resources/extras/sonarcloud-sonarlint.md).

# SonarCloud / SonarLint

## SonarLint Installation Guide:

*Prerequisites*: 

* [VSCode](https://code.visualstudio.com/) with [Salesforce Extensions](https://marketplace.visualstudio.com/items?itemName=salesforce.salesforcedx-vscode) installed, [configured and connected](https://trailhead.salesforce.com/en/content/learn/projects/quickstart-vscode-salesforce) to both Azure DevOps and your ScratchOrg.
* A SonarCloud account (Free for public projects / \~$10mo for most Salesforce projects) - with a  project set up which will be used for the SFDX code analysis, note the projectKey as it will be used in step 14.

Configuration Process:

1. Install the [SonarLint Extension](https://marketplace.visualstudio.com/items?itemName=SonarSource.sonarlint-vscode) into VSCode, and restart VSCode
2. Open your VSCode project related to your ScratchOrg
3. Visit [SonarCloud](https://sonarcloud.io/) and log in using the **Azure DevOps** button.
4. Visit [your security page](https://sonarcloud.io/account/security/)
5. Under the section titled **Generate Tokens**, enter `vscode` and click the **Generate** button.
6. You will get a new token, copy the token value secure location we will use it later and you will not be able to retrieve it once it is generated.
7. Open Visual Studio Code, and navigate to the setting section
   * On Windows/Linux - File > Preferences > Settings
   * On macOS - Code > Preferences > Settings
8. Select User Settings and Search for SonarLint
9. Ensure that you select **User** directly under the search box so that you are configuring user settings.
10. Pick any of the settings and click \*\*Edit in settings.json
11. Paste the following into the settings.json file

    ```
    "sonarlint.connectedMode.connections.sonarcloud": [
        {
          "organizationKey": "<<YOUR COMPANY NAME>>",
          "token": "<<YOUR VSCODE TOKEN GOES HERE>>"
        }
      ],
    "sonarlint.connectedMode.project": {
        "projectKey": "<<YOUR PROJECT KEY>>"
      },
    ```
12. Replace the <\<YOUR VSCODE TOKEN GOES HERE>> with the *token* you created earlier.
13. Replace the <\<YOUR COMPANY NAME>> with your *organization key*&#x20;
    * You can look up the *organization key* on the [organization key page](https://sonarcloud.io/account/organizations).
14. Replace the <\<YOUR PROJECT KEY>> with your *project key*.
    * You can look up the *project key* under Administration > Projects Management on your organization's page.
15. You will also likely want to set the Sonarlint > LS: Java Home to the follow the path to your JDK in the same manner you had do to when installing [AdoptOpenJavaSDK](https://developer.salesforce.com/tools/vscode/en/getting-started/java-setup/#adoptopenjdk)
16. Restart VSCode and reopen your VSCode Project related to your ScratchOrg

The following is a sample settings.json file for reference:

```
{
    "sonarlint.connectedMode.connections.sonarcloud": [
        {
          "organizationKey": "ecfmg",
          "token": "b33e974....76331859"
        }
      ],
    "sonarlint.connectedMode.project": {
        "projectKey": "sfdc"
      },
    "salesforcedx-vscode-apex.java.home": "/Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home",
    "sonarlint.ls.javaHome": "/Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home"
}
```