Installation overview

Main steps for installing SonarQube Server from the ZIP file.

Installing SonarQube Server from the ZIP file is deprecated. It's still supported, but support will be removed in a future release, so consider the Docker image or the Helm chart instead. See the deprecation policy for details.

The agentic features run as containers, so they have no ZIP equivalent. You can keep SonarQube Server on the ZIP file and deploy their containers alongside it. See Deploying AI agents.

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