> 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-server/2025.5/server-installation/from-zip-file/overview.md).

# Installation overview

{% hint style="info" %}
We recommend installing SonarQube Server from a [Docker image](https://hub.docker.com/_/sonarqube) or [Helm chart](https://artifacthub.io/packages/helm/sonarqube/sonarqube) (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.
{% endhint %}

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

1. Check the [Server host requirements](/sonarqube-server/2025.5/server-installation/server-host-requirements.md) (in particular, make sure the correct Java version is installed).
2. Perform the pre-installation steps:
   * [On Linux systems](/sonarqube-server/2025.5/server-installation/pre-installation/linux.md)
   * [On Unix-based systems](/sonarqube-server/2025.5/server-installation/pre-installation/unix.md)
   * [On macOS systems](/sonarqube-server/2025.5/server-installation/pre-installation/macos.md)
   * [Defining a JWT token](/sonarqube-server/2025.5/server-installation/pre-installation/jwt-token.md) (to keep user sessions alive during startup)
3. Install the database. See [Installing database](/sonarqube-server/2025.5/server-installation/installing-the-database.md).
4. Perform the installation and basic setup. See [Basic installation](/sonarqube-server/2025.5/server-installation/from-zip-file/basic-installation.md).
5. Depending on your environment, you may have to perform advanced setup. See [Advanced setup](/sonarqube-server/2025.5/server-installation/from-zip-file/advanced-setup.md).
6. You can:
   * Install SonarQube Server as a service. See [Running as a service](/sonarqube-server/2025.5/server-installation/from-zip-file/starting-stopping-server/running-as-a-service.md).
   * Secure SonaQube Server behind a proxy. See [Reverse proxy and network security](/sonarqube-server/2025.5/server-installation/network-security/securing-behind-proxy.md).
   * Configure network rules. See [Network rules](/sonarqube-server/2025.5/server-installation/network-security/network-rules.md)
7. Start your SonarQube Server. See [From the ZIP file](/sonarqube-server/2025.5/server-installation/from-zip-file/starting-stopping-server/from-zip-file.md).
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**.

{% hint style="info" %}
Check out this [video](https://www.youtube.com/watch?v=O0yFLS30InY) on installing SonarQube Server on Windows for a process overview.
{% endhint %}

## Related pages <a href="#related-pages" id="related-pages"></a>

* [Basic installation](/sonarqube-server/2025.5/server-installation/from-zip-file/basic-installation.md)
* [Advanced setup](/sonarqube-server/2025.5/server-installation/from-zip-file/advanced-setup.md)
* **Configuring network security features:**
  * [Reverse proxy and network security](/sonarqube-server/2025.5/server-installation/network-security/securing-behind-proxy.md)
  * [Network rules](/sonarqube-server/2025.5/server-installation/network-security/network-rules.md)
* [Starting / stopping server](/sonarqube-server/2025.5/server-installation/from-zip-file/starting-stopping-server.md)
* [Running as a service](/sonarqube-server/2025.5/server-installation/from-zip-file/starting-stopping-server/running-as-a-service.md)
* Installing the Data Center Edition from the ZIP file: [Installing from ZIP file](/sonarqube-server/2025.5/server-installation/data-center-edition/from-zip-file.md)


---

# 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-server/2025.5/server-installation/from-zip-file/overview.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.