Browse Source

DOCS make "don't run as root" more explicit

tags/7.7
G. Ann Campbell 5 years ago
parent
commit
209aa0bbb1

+ 1
- 1
server/sonar-docs/src/pages/setup/get-started-2-minutes.md View File

@@ -15,7 +15,7 @@ url: /setup/get-started-2-minutes/
# On Windows, execute:
C:\sonarqube\bin\windows-x86-xx\StartSonar.bat

# On other operating systems, execute:
# On other operating systems, as a non-root user execute:
/opt/sonarqube/bin/[OS]/sonar.sh console
```


+ 6
- 2
server/sonar-docs/src/pages/setup/install-server.md View File

@@ -70,9 +70,9 @@ Once all SonarQube tables are using the InnoDB engine, the first thing to do is

## Installing the Web Server

First, check the [requirements](/requirements/requirements/). Note that you cannot run the SonarQube server as `root` on Unix-based systems.
First, check the [requirements](/requirements/requirements/). Then download and unzip the [distribution](http://www.sonarqube.org/downloads/) (do not unzip into a directory starting with a digit).

Then download and unzip the [distribution](http://www.sonarqube.org/downloads/) (do not unzip into a directory starting with a digit).
SonarQube cannot be run as `root` on Unix-based systems, so create a dedicated user account to use for SonarQube if necessary.

_$SONARQUBE-HOME_ (below) refers to the path to the directory where the SonarQube distribution has been unzipped.

@@ -197,3 +197,7 @@ http.proxyUser=domain\\user
```

For some proxies, the exception "java.net.ProtocolException: Server redirected too many times" might mean an incorrect username or password has been configured.

### Exception java.lang.RuntimeException: can not run elasticsearch as root

SonarQube starts an Elasticsearch process, and the same account that is running SonarQube itself will be used for the Elasticsearch process. Since Elasticsearch cannot be run as `root`, that means SonarQube can't be either. You must choose some other, non-`root` account with which to run SonarQube, preferably an account dedicated to the purpose.

+ 1
- 1
server/sonar-docs/src/pages/setup/operate-server.md View File

@@ -23,7 +23,7 @@ url: /setup/operate-server/

## Running SonarQube as a Service on Linux with SystemD

On Unix system using SystemD, you can install SonarQube as a service.
On Unix system using SystemD, you can install SonarQube as a service. You cannot run SonarQube as `root` in 'nix systems. Ideally, you will created a new account dedicated to the purpose of running SonarQube.
Let's suppose:

* The user used to start the service is `sonarqube`

Loading…
Cancel
Save