9.

8 | Requirements | Prerequisites and overview

On this page

PrerequisiteHardware requirementsSupported platformsPlatform notes

Prerequisites and overview

Prerequisite

You must be able to install Java (Oracle JRE or OpenJDK) on the machine
where you plan to run SonarQube.

Hardware requirements
1. A small-scale (individual or small team) instance of the SonarQube server
requires at least 2GB of RAM to run efficiently and 1GB of free RAM for the
OS. If you are installing an instance for a large team or an enterprise, please
consider the additional recommendations below.
2. The amount of disk space you need will depend on how much code you
analyze with SonarQube.
 3. SonarQube must be installed on hard drives that have excellent read &
write performance. Most importantly, the "data" folder houses the
Elasticsearch indices on which a huge amount of I/O will be done when the
server is up and running. Read and write hard drive performance will
therefore have a big impact on the overall SonarQube server performance.

Enterprise hardware recommendations

For large teams or enterprise-scale installations of SonarQube, additional hardware is required. At the enterprise level, monito
 8 cores, to allow the main SonarQube platform to run with multiple compute
engine workers

16GB of RAM For additional requirements and recommendations relating to database and Elasticsearch, see Hardware recom

Supported platforms

Java
Both the SonarQube server and the SonarQube scanners require Java version 11
or 17.

SonarQube is able to analyze any kind of Java source files regardless of the
version of Java they comply with.
We recommend using the critical patch update (CPU) releases.

Java

Oracle JRE

OpenJDK

Database

PostgreSQL
Microsoft SQL Server
Oracle
Oracle
Web browser

To get the full experience SonarQube has to offer, you must enable JavaScript
in your browser.

Browser

Microsoft Edge

Mozilla Firefox
 Mozilla Firefox

Google Chrome

Opera

Safari

Platform notes

Linux

If you're running on Linux, you must ensure that:

vm.max_map_count is greater than or equal to 524288

fs.file-max is greater than or equal to 131072

 the user running SonarQube can open at least 131072 file descriptors

the user running SonarQube can open at least 8192 threads

You can see the values with the following commands:

sysctl vm.max_map_count
sysctl fs.file-max
ulimit -n
ulimit -u
You can set them dynamically for the current session by running the following
commands as root:

sysctl -w vm.max_map_count=524288
sysctl -w fs.file-max=131072
ulimit -n 131072
ulimit -u 8192
To set these values more permanently, you must update
either /etc/sysctl.d/99-sonarqube.conf (or /etc/sysctl.conf as you wish) to
reflect these values.
If the user running SonarQube (sonarqube in this example) does not have
permission to have at least 131072 open descriptors, you must insert this line
in /etc/security/limits.d/99-sonarqube.conf (or /etc/security/limits.conf as
you wish):

sonarqube - nofile 131072

sonarqube - nproc 8192
If you are using systemd to start SonarQube, you must specify those limits
inside your unit file in the section [Service] :

[Service]
...
LimitNOFILE=131072
LimitNPROC=8192
...

seccomp filter
By default, Elasticsearch uses seccomp filter. In most distributions, this feature is activated in the kernel, however on distributi

sonar.search.javaAdditionalOpts=-Dbootstrap.system_call_filter=false

You can check if seccomp is available on your kernel with:

$ grep SECCOMP /boot/config-$(uname -r)

If your kernel has seccomp, you will see:

CONFIG_HAVE_ARCH_SECCOMP_FILTER=y
CONFIG_SECCOMP_FILTER=y
CONFIG_SECCOMP=y

For more detail, see the Elasticsearch documentation.

Fonts

Generating executive reports requires that fonts be installed on the server hosting SonarQube. On Windows servers, this is a g
The following should be ensured:

Fontconfig is installed on the server hosting SonarQube

A package of FreeType fonts is installed on the SonarQube server. The exact packages available will vary by distribution, but

FIPS
SonarQube will not run on Linux hosts where FIPS (Federal Information
Processing Standard) is enforced.
 1202 1203 1204 1205 1206 1207

120740.9 120841.35 120941.8 121042.25 121142.7 121243.15

12128423.405 12138513.608 12148603.81 12158694.013 12168784.215 12178874.418

1218300131 1219313692 1220327253 1221340814 1222354374 1223367935

122378248162122480060349122581872535122683684722122785496908122887309095
 1.22929E+13 1.230312E+13 1.231335E+13 1.232358E+13 1.23338E+13 1.234403E+13
1.234821E+15 1.235849E+15 1.236876E+15 1.237903E+15 1.238931E+15 1.239958E+15
1.240378E+17 1.24141E+17 1.242442E+17 1.243474E+17 1.244506E+17 1.245538E+17
1.24596E+19 1.246996E+19 1.248033E+19 1.249069E+19 1.250106E+19 1.251143E+19

1.251567E+21 1.252608E+21 1.253649E+21 1.25469E+21 1.255731E+21 1.256773E+21

1.257199E+23 1.258244E+23 1.25929E+23 1.260336E+23 1.261382E+23 1.262428E+23

1.262856E+25 1.263907E+25 1.264957E+25 1.266008E+25 1.267058E+25 1.268109E+25

1.268539E+27 1.269594E+27 1.27065E+27 1.271705E+27 1.27276E+27 1.273816E+27
1.274247E+29 1.275307E+29 1.276367E+29 1.277428E+29 1.278488E+29 1.279548E+29
1.279981E+31 1.281046E+31 1.282111E+31 1.283176E+31 1.284241E+31 1.285306E+31
1.285741E+33 1.286811E+33 1.287881E+33 1.28895E+33 1.29002E+33 1.29109E+33
1.291527E+35 1.292602E+35 1.293676E+35 1.294751E+35 1.295825E+35 1.2969E+35

1.297339E+37 1.298418E+37 1.299498E+37 1.300577E+37 1.301656E+37 1.302736E+37

1.303177E+39 1.304261E+39 1.305345E+39 1.30643E+39 1.307514E+39 1.308598E+39
1.309041E+41 1.31013E+41 1.311219E+41 1.312308E+41 1.313398E+41 1.314487E+41
1.314932E+43 1.316026E+43 1.31712E+43 1.318214E+43 1.319308E+43 1.320402E+43
1.320849E+45 1.321948E+45 1.323047E+45 1.324146E+45 1.325245E+45 1.326344E+45

1.326793E+47 1.327897E+47 1.329001E+47 1.330104E+47 1.331208E+47 1.332312E+47

1.332764E+49 1.333872E+49 1.334981E+49 1.33609E+49 1.337199E+49 1.338308E+49

1.338761E+51 1.339875E+51 1.340989E+51 1.342102E+51 1.343216E+51 1.34433E+51

1.344785E+53 1.345904E+53 1.347023E+53 1.348142E+53 1.349261E+53 1.350379E+53
1.350837E+55 1.351961E+55 1.353085E+55 1.354208E+55 1.355332E+55 1.356456E+55
1.356916E+57 1.358045E+57 1.359173E+57 1.360302E+57 1.361431E+57 1.36256E+57
1.363022E+59 1.364156E+59 1.36529E+59 1.366424E+59 1.367558E+59 1.368692E+59
1.369155E+61 1.370295E+61 1.371434E+61 1.372573E+61 1.373712E+61 1.374851E+61

1.375317E+63 1.376461E+63 1.377605E+63 1.378749E+63 1.379893E+63 1.381038E+63

1.381506E+65 1.382655E+65 1.383804E+65 1.384954E+65 1.386103E+65 1.387252E+65
 1.387722E+67 1.388877E+67 1.390031E+67 1.391186E+67 1.39234E+67 1.393495E+67
1.393967E+69 1.395127E+69 1.396287E+69 1.397446E+69 1.398606E+69 1.399766E+69

Server Scanners
1.40024E+71 1.401405E+71 1.40257E+71 1.403735E+71 1.4049E+71 1.406065E+71
1.406541E+73 1.407711E+73 1.408881E+73 1.410052E+73 1.411222E+73 1.412392E+73

17 17

11 11

8 8

17 17

11 11

8 8

15

14

13
12

11

Must be
configured
to use
UTF-8
charset

2019
(MSSQL
Server
15.0) with
bundled
Microsoft
JDBC
driver.
Express
Edition is
supported.

2017
(MSSQL
Server
14.0) with
bundled
Microsoft
JDBC
driver.
Express
Edition is
supported.
2016
(MSSQL
Server
13.0) with
bundled
Microsoft
JDBC
driver.
Express
Edition is
supported.

2014
(MSSQL
Server
12.0) with
bundled
Microsoft
JDBC
driver.
Express
Edition is
supported.

Collation
must be
case-
sensitive
(CS) and
accent-
sensitive
(AS)
(example:
Latin1_G
eneral_C
S_AS).
READ_COM
MITTED_S
NAPSHOT
must be set
on the
SonarQube
database to
avoid
potential
deadlocks
under
heavy load.

Both Windows authentication (“Integrated Security”) and SQL Server authentication are supported. See the Microsoft SQL Se
19C

18C

12C

XE
Editions

Must be
configured
to use a
UTF8-
family
charset
(see NLS_C
HARACTER
SET).

The
driver ojd
bc14.jar
is not
supported.

We
recommen
d using the
latest
Oracle
JDBC
driver.
Only the
thin mode
is
supported,
not OCI.

Only MAX_
STRING_S
IZE=STAN
DARD para
meter is
supported,
not EXTEN
DED.

Latest
Latest

Latest

Not tested

Latest
 1208 1209 1210 1211 1212 1213 1214

121343.6 121444.05 121544.5 121644.95 121745.4 121845.85 121946.3

12188964.62 12199054.823 12209145.025 12219235.228 12229325.43 12239415.633 12249505.835

1224381496 1225395057 1226408618 1227422179 1228435739 1229449300 1230462861

122989121281123090933468123192745654123294557841123396370027123498182214123599994400
1.235426E+13 1.236448E+13 1.237471E+13 1.238494E+13 1.239517E+13 1.240539E+13 1.241562E+13
1.240985E+15 1.242012E+15 1.24304E+15 1.244067E+15 1.245094E+15 1.246122E+15 1.247149E+15
1.24657E+17 1.247602E+17 1.248633E+17 1.249665E+17 1.250697E+17 1.251729E+17 1.252761E+17
1.252179E+19 1.253216E+19 1.254252E+19 1.255289E+19 1.256325E+19 1.257362E+19 1.258399E+19

1.257814E+21 1.258855E+21 1.259896E+21 1.260938E+21 1.261979E+21 1.26302E+21 1.264061E+21

1.263474E+23 1.26452E+23 1.265566E+23 1.266612E+23 1.267658E+23 1.268704E+23 1.26975E+23

1.26916E+25 1.27021E+25 1.271261E+25 1.272312E+25 1.273362E+25 1.274413E+25 1.275464E+25

1.274871E+27 1.275926E+27 1.276982E+27 1.278037E+27 1.279092E+27 1.280148E+27 1.281203E+27
1.280608E+29 1.281668E+29 1.282728E+29 1.283788E+29 1.284848E+29 1.285908E+29 1.286969E+29
1.286371E+31 1.287435E+31 1.2885E+31 1.289565E+31 1.29063E+31 1.291695E+31 1.29276E+31
1.292159E+33 1.293229E+33 1.294299E+33 1.295368E+33 1.296438E+33 1.297508E+33 1.298577E+33
1.297974E+35 1.299048E+35 1.300123E+35 1.301197E+35 1.302272E+35 1.303346E+35 1.304421E+35

1.303815E+37 1.304894E+37 1.305974E+37 1.307053E+37 1.308132E+37 1.309211E+37 1.310291E+37

1.309682E+39 1.310766E+39 1.31185E+39 1.312935E+39 1.314019E+39 1.315103E+39 1.316187E+39
1.315576E+41 1.316665E+41 1.317754E+41 1.318843E+41 1.319932E+41 1.321021E+41 1.32211E+41
1.321496E+43 1.32259E+43 1.323684E+43 1.324778E+43 1.325872E+43 1.326965E+43 1.328059E+43
1.327442E+45 1.328541E+45 1.32964E+45 1.330739E+45 1.331838E+45 1.332937E+45 1.334036E+45

1.333416E+47 1.33452E+47 1.335624E+47 1.336727E+47 1.337831E+47 1.338935E+47 1.340039E+47

1.339416E+49 1.340525E+49 1.341634E+49 1.342743E+49 1.343851E+49 1.34496E+49 1.346069E+49

1.345444E+51 1.346557E+51 1.347671E+51 1.348785E+51 1.349899E+51 1.351013E+51 1.352126E+51

1.351498E+53 1.352617E+53 1.353736E+53 1.354855E+53 1.355973E+53 1.357092E+53 1.358211E+53
1.35758E+55 1.358704E+55 1.359828E+55 1.360951E+55 1.362075E+55 1.363199E+55 1.364323E+55
1.363689E+57 1.364818E+57 1.365947E+57 1.367076E+57 1.368205E+57 1.369333E+57 1.370462E+57
1.369826E+59 1.37096E+59 1.372094E+59 1.373228E+59 1.374361E+59 1.375495E+59 1.376629E+59
1.37599E+61 1.377129E+61 1.378268E+61 1.379407E+61 1.380546E+61 1.381685E+61 1.382824E+61

1.382182E+63 1.383326E+63 1.38447E+63 1.385614E+63 1.386759E+63 1.387903E+63 1.389047E+63

1.388402E+65 1.389551E+65 1.3907E+65 1.39185E+65 1.392999E+65 1.394148E+65 1.395298E+65
1.394649E+67 1.395804E+67 1.396958E+67 1.398113E+67 1.399267E+67 1.400422E+67 1.401576E+67
1.400925E+69 1.402085E+69 1.403245E+69 1.404404E+69 1.405564E+69 1.406724E+69 1.407884E+69

1.40723E+71 1.408394E+71 1.409559E+71 1.410724E+71 1.411889E+71 1.413054E+71 1.414219E+71

1.413562E+73 1.414732E+73 1.415902E+73 1.417073E+73 1.418243E+73 1.419413E+73 1.420583E+73
 1215 1216 1217 1218 1219 1220 1221

122046.75 122147.2 122247.65 122348.1 122448.55 122549 122649.45

12259596.038 12269686.24 12279776.442 12289866.645 12299956.848 12310047.05 12320137.253

1231476422 1232489983 1233503544 1234517104 1235530665 1236544226 1237557787

123701806587123803618773123905430960124007243146124109055333124210867519124312679706
1.242585E+13 1.243607E+13 1.24463E+13 1.245653E+13 1.246675E+13 1.247698E+13 1.248721E+13
1.248176E+15 1.249204E+15 1.250231E+15 1.251258E+15 1.252286E+15 1.253313E+15 1.25434E+15
1.253793E+17 1.254825E+17 1.255857E+17 1.256889E+17 1.257921E+17 1.258953E+17 1.259985E+17
1.259435E+19 1.260472E+19 1.261508E+19 1.262545E+19 1.263581E+19 1.264618E+19 1.265655E+19

1.265103E+21 1.266144E+21 1.267185E+21 1.268226E+21 1.269268E+21 1.270309E+21 1.27135E+21

1.270796E+23 1.271841E+23 1.272887E+23 1.273933E+23 1.274979E+23 1.276025E+23 1.277071E+23

1.276514E+25 1.277565E+25 1.278615E+25 1.279666E+25 1.280717E+25 1.281767E+25 1.282818E+25

1.282258E+27 1.283314E+27 1.284369E+27 1.285425E+27 1.28648E+27 1.287535E+27 1.288591E+27
1.288029E+29 1.289089E+29 1.290149E+29 1.291209E+29 1.292269E+29 1.293329E+29 1.294389E+29
1.293825E+31 1.29489E+31 1.295954E+31 1.297019E+31 1.298084E+31 1.299149E+31 1.300214E+31
1.299647E+33 1.300717E+33 1.301786E+33 1.302856E+33 1.303926E+33 1.304995E+33 1.306065E+33
1.305495E+35 1.30657E+35 1.307644E+35 1.308719E+35 1.309793E+35 1.310868E+35 1.311942E+35

1.31137E+37 1.312449E+37 1.313529E+37 1.314608E+37 1.315687E+37 1.316767E+37 1.317846E+37

1.317271E+39 1.318355E+39 1.31944E+39 1.320524E+39 1.321608E+39 1.322692E+39 1.323776E+39
1.323199E+41 1.324288E+41 1.325377E+41 1.326466E+41 1.327555E+41 1.328644E+41 1.329733E+41
1.329153E+43 1.330247E+43 1.331341E+43 1.332435E+43 1.333529E+43 1.334623E+43 1.335717E+43
1.335135E+45 1.336233E+45 1.337332E+45 1.338431E+45 1.33953E+45 1.340629E+45 1.341728E+45

1.341143E+47 1.342246E+47 1.34335E+47 1.344454E+47 1.345558E+47 1.346662E+47 1.347766E+47

1.347178E+49 1.348287E+49 1.349395E+49 1.350504E+49 1.351613E+49 1.352722E+49 1.353831E+49

1.35324E+51 1.354354E+51 1.355468E+51 1.356581E+51 1.357695E+51 1.358809E+51 1.359923E+51

1.35933E+53 1.360448E+53 1.361567E+53 1.362686E+53 1.363805E+53 1.364924E+53 1.366042E+53
1.365447E+55 1.366571E+55 1.367694E+55 1.368818E+55 1.369942E+55 1.371066E+55 1.37219E+55
1.371591E+57 1.37272E+57 1.373849E+57 1.374978E+57 1.376107E+57 1.377236E+57 1.378364E+57
1.377763E+59 1.378897E+59 1.380031E+59 1.381165E+59 1.382299E+59 1.383433E+59 1.384567E+59
1.383963E+61 1.385102E+61 1.386241E+61 1.38738E+61 1.38852E+61 1.389659E+61 1.390798E+61

1.390191E+63 1.391335E+63 1.39248E+63 1.393624E+63 1.394768E+63 1.395912E+63 1.397056E+63

1.396447E+65 1.397596E+65 1.398746E+65 1.399895E+65 1.401044E+65 1.402194E+65 1.403343E+65
1.402731E+67 1.403886E+67 1.40504E+67 1.406195E+67 1.407349E+67 1.408504E+67 1.409658E+67
1.409043E+69 1.410203E+69 1.411363E+69 1.412522E+69 1.413682E+69 1.414842E+69 1.416002E+69

1.415384E+71 1.416549E+71 1.417714E+71 1.418879E+71 1.420044E+71 1.421209E+71 1.422374E+71

1.421753E+73 1.422923E+73 1.424094E+73 1.425264E+73 1.426434E+73 1.427604E+73 1.428774E+73
 1222 1223 1224 1225 1226 1227 1228

122749.9 122850.35 122950.8 123051.25 123151.7 123252.15 123352.6

12330227.455 12340317.658 12350407.86 12360498.063 12370588.265 12380678.468 12390768.67

1238571348 1239584909 1240598470 1241612030 1242625591 1243639152 1244652713

124414491892124516304079124618116265124719928451124821740638124923552824125025365011
1.249744E+13 1.250766E+13 1.251789E+13 1.252812E+13 1.253834E+13 1.254857E+13 1.25588E+13
1.255367E+15 1.256395E+15 1.257422E+15 1.258449E+15 1.259477E+15 1.260504E+15 1.261531E+15
1.261017E+17 1.262048E+17 1.26308E+17 1.264112E+17 1.265144E+17 1.266176E+17 1.267208E+17
1.266691E+19 1.267728E+19 1.268764E+19 1.269801E+19 1.270837E+19 1.271874E+19 1.272911E+19

1.272391E+21 1.273432E+21 1.274474E+21 1.275515E+21 1.276556E+21 1.277597E+21 1.278639E+21

1.278117E+23 1.279163E+23 1.280209E+23 1.281255E+23 1.282301E+23 1.283347E+23 1.284393E+23

1.283869E+25 1.284919E+25 1.28597E+25 1.28702E+25 1.288071E+25 1.289122E+25 1.290172E+25

1.289646E+27 1.290701E+27 1.291757E+27 1.292812E+27 1.293867E+27 1.294923E+27 1.295978E+27
1.295449E+29 1.296509E+29 1.29757E+29 1.29863E+29 1.29969E+29 1.30075E+29 1.30181E+29
1.301279E+31 1.302344E+31 1.303409E+31 1.304474E+31 1.305538E+31 1.306603E+31 1.307668E+31
1.307135E+33 1.308204E+33 1.309274E+33 1.310344E+33 1.311413E+33 1.312483E+33 1.313553E+33
1.313017E+35 1.314091E+35 1.315166E+35 1.31624E+35 1.317315E+35 1.318389E+35 1.319464E+35

1.318925E+37 1.320005E+37 1.321084E+37 1.322163E+37 1.323243E+37 1.324322E+37 1.325401E+37

1.32486E+39 1.325945E+39 1.327029E+39 1.328113E+39 1.329197E+39 1.330281E+39 1.331366E+39
1.330822E+41 1.331911E+41 1.333E+41 1.33409E+41 1.335179E+41 1.336268E+41 1.337357E+41
1.336811E+43 1.337905E+43 1.338999E+43 1.340093E+43 1.341187E+43 1.342281E+43 1.343375E+43
1.342827E+45 1.343926E+45 1.345024E+45 1.346123E+45 1.347222E+45 1.348321E+45 1.34942E+45

1.348869E+47 1.349973E+47 1.351077E+47 1.352181E+47 1.353285E+47 1.354389E+47 1.355492E+47

1.354939E+49 1.356048E+49 1.357157E+49 1.358266E+49 1.359374E+49 1.360483E+49 1.361592E+49

1.361037E+51 1.36215E+51 1.363264E+51 1.364378E+51 1.365492E+51 1.366605E+51 1.367719E+51

1.367161E+53 1.36828E+53 1.369399E+53 1.370518E+53 1.371636E+53 1.372755E+53 1.373874E+53
1.373313E+55 1.374437E+55 1.375561E+55 1.376685E+55 1.377809E+55 1.378933E+55 1.380056E+55
1.379493E+57 1.380622E+57 1.381751E+57 1.38288E+57 1.384009E+57 1.385138E+57 1.386267E+57
1.385701E+59 1.386835E+59 1.387969E+59 1.389103E+59 1.390237E+59 1.391371E+59 1.392505E+59
1.391937E+61 1.393076E+61 1.394215E+61 1.395354E+61 1.396493E+61 1.397632E+61 1.398771E+61

1.3982E+63 1.399345E+63 1.400489E+63 1.401633E+63 1.402777E+63 1.403921E+63 1.405066E+63

1.404492E+65 1.405642E+65 1.406791E+65 1.40794E+65 1.40909E+65 1.410239E+65 1.411388E+65
1.410813E+67 1.411967E+67 1.413122E+67 1.414276E+67 1.415431E+67 1.416585E+67 1.41774E+67
1.417161E+69 1.418321E+69 1.419481E+69 1.42064E+69 1.4218E+69 1.42296E+69 1.424119E+69

1.423538E+71 1.424703E+71 1.425868E+71 1.427033E+71 1.428198E+71 1.429363E+71 1.430528E+71

1.429944E+73 1.431115E+73 1.432285E+73 1.433455E+73 1.434625E+73 1.435795E+73 1.436965E+73
 1229

123453.05
12400858.873

1245666274
125127177197
1.256902E+13
1.262559E+15
1.26824E+17
1.273947E+19

1.27968E+21
1.285438E+23

1.291223E+25
1.297033E+27
1.30287E+29
1.308733E+31
1.314622E+33
1.320538E+35

1.326481E+37
1.33245E+39
1.338446E+41
1.344469E+43
1.350519E+45

1.356596E+47
1.362701E+49

1.368833E+51
1.374993E+53
1.38118E+55
1.387396E+57
1.393639E+59
1.39991E+61

1.40621E+63
1.412538E+65
1.418894E+67
1.425279E+69

1.431693E+71
1.438136E+73