Installation overview

Main steps for installing SonarQube Server from the ZIP file.

We recommend installing SonarQube Server from a Docker image or Helm chart (Kubernetes/OpenShift). These methods make it easier to update to newer versions and to operate your instance. Install from the ZIP file only if neither of those options is feasible for your environment.

To install your SonarQube Server (Developer or Enterprise edition) from the ZIP file:

1. Check the Server host requirements (in particular, make sure the correct Java version is installed).

2. Perform the pre-installation steps:

   • On Linux systems

   • On Unix-based systems

   • On macOS systems

   • Defining a JWT token (to keep user sessions alive during startup)

3. Install the database. See Installing database.

4. Perform the installation and basic setup. See Basic installation.

5. Depending on your environment, you may have to perform advanced setup. See Advanced setup.

6. You can:

   • Install SonarQube Server as a service. See Running as a service.

   • Secure SonaQube Server behind a proxy. See Reverse proxy and network security.

   • Configure network rules. See Network rules

7. Start your SonarQube Server. See From the ZIP file.

8. You can now open SonarQube Server in your web browser at the configured address (by default http://localhost:9000). The default system administrator credentials are admin/admin.

Check out this video on installing SonarQube Server on Windows for a process overview.

Related pages

• Basic installation

• Advanced setup

• Configuring network security features:

  • Reverse proxy and network security

  • Network rules

• Starting / stopping server

• Running as a service

• Installing the Data Center Edition from the ZIP file: Installing from ZIP file