Skip to content
This version of SonarQube Server is no longer receiving patches. Please see the latest release for details on updating.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Advanced setup

Advanced setup when installing SonarQube Server 2025.3 from the Docker image.

For AI agents: You're in the SonarQube Server 2025.3 documentation. SonarQube Server 2025.3 is no longer patched. To get patches, upgrade to the latest version. For a list of all 2025.3 pages, see the SonarQube Server 2025.3 page index. For the whole site, see the page index or the full text. For another version, replace 2025.3 in the URL with that version. The latest version has no version number in its URL.

Self Signed Certificates of DevOps platforms

In our official Docker images, you can find the systems truststore in <JAVA_HOME>/lib/security/cacerts. In order to add new certificates here as well you can:

  • Bind mount an existing truststore containing your certificates to <JAVA_HOME>/lib/security/cacerts.

Example
docker run -d --name sonarqube -v /path/to/your/cacerts.truststore:/opt/java/openjdk/lib/security/cacerts:ro -p 9000:9000 sonarqube 
  • Import your CA certificate the same way as in the zip installation but inside the container.

Changing SonarQube DNS cache TTL

When reporting Quality Gate status to DevOps platforms, SonarQube uses a DNS cache time to live policy of 30 seconds. If necessary, you can change this setting in your JVM:

echo "networkaddress.cache.ttl=5" >> "${JAVA_HOME}/conf/security/java.security" 

Please be aware that low values increase the risk of DNS spoofing attacks.

Adjusting Java executable path

By default, the scripts will use the Java executable available in the PATH. If multiple versions of Java are installed on your server, you may need to explicitly define which version is used.

It is possible to overwrite the default Java executable by setting the environmental variable SONAR_JAVA_PATH.

Linux
Windows

Enabling IPv6

When you run your Docker container:

  • Enable IPv6 in the JVM by setting the JAVA_TOOL_OPTIONS environment variable to -Djava.net.preferIPv6Addresses=true.

  • Enable IPv6 in SonarQube by setting the SONAR_WEB_JAVAADDITIONALOPTS environment variable (system property) to -Djava.net.preferIPv6Addresses=true.

See below for instructions depending on the Docker tool used.

With docker-run

Set the environment variables in the docker run command as illustrated below.

For image_name, check the tags currently available on the DockerHub page.

With docker-compose

Set the environment variables in the environment section of the .yml file as illustrated below.

Keeping user sessions alive on server restart

To maintain your user sessions accross server restarts:

Last updated

Was this helpful?