Self-hosting

SonarQube sur VPS : analyse de qualité et de sécurité du code

Une revue de code humaine voit l'intention ; elle laisse passer la requête SQL concaténée, la variable jamais utilisée ou le bloc copié trois fois. SonarQube relit chaque analyse avec plusieurs milliers de règles et tranche par un quality gate : le nouveau code passe ou il ne passe pas. Ce guide installe l'édition open source, SonarQube Community Build, sur un VPS avec Docker Compose, remplace le mot de passe d'usine, la publie en HTTPS derrière nginx et la branche sur votre CI.

Déployer sur un VPS Cloud →
6 min de lecture4 étapes

Orbi agent IALe sommaire suit l’article ; les articles liés vous attendent en bas de page.

Sommaire· Ce que fait SonarQube1/11
  1. 01Ce que fait SonarQube
  2. 02Ce que SonarQube vous donne
  3. 03Revue manuelle seule ou SonarQube sur votre VPS
  4. 04Préparer le serveur
  5. 05Installer SonarQube avec Docker Compose
  6. 06Ne publiez jamais une instance en admin/admin
  7. 07Publier SonarQube en HTTPS derrière nginx
  8. 08Analyser un premier projet
  9. 09Bloquer un pipeline sur le quality gate
  10. 10Sauvegarde et mise à jour
  11. 11SonarQube en un clic sur ServOrbit

Ce que fait SonarQube

SonarQube est une plateforme d'analyse statique : elle lit le code sans l'exécuter et signale ce qui risque de casser, de fuir ou de coûter cher à maintenir. Chaque défaut est classé — bug, vulnérabilité, point sensible de sécurité à revoir, mauvaise odeur de code — et renvoie à une règle documentée, avec un exemple de correction.

L'édition Community Build est publiée par SonarSource sous licence LGPL-3.0. Elle couvre une vingtaine de langages, dont Java, JavaScript et TypeScript, Python, PHP, C#, Go et Kotlin, ainsi que l'infrastructure as code (Terraform, Kubernetes, Dockerfile). Elle analyse la branche principale de chaque projet ; l'analyse des branches, des pull requests et des langages C et C++ relève des éditions commerciales.

Ce que SonarQube vous donne

  • Un quality gate — un verdict clair à chaque analyse, que votre pipeline peut attendre avant de déployer.
  • La sécurité dans la boucle — injections, secrets en clair et configurations faibles signalés dès le commit.
  • Des règles expliquées — chaque défaut porte sa justification et un exemple de correction.
  • Le suivi dans le temps — dette technique, code dupliqué et couverture de tests, version après version.
  • Votre code chez vous — rien ne quitte votre VPS, ni le code ni les résultats.
  • Une API complète — projets, jetons, quality gates et webhooks pilotables par script.

Revue manuelle seule ou SonarQube sur votre VPS

Faites défiler le tableau

Revue manuelle seuleAvec SonarQube sur votre VPS
Défauts répétitifsDépend de l'attention du relecteurRelevés à chaque analyse
Failles connuesRepérées si on les connaîtRègles de sécurité appliquées partout
Décision de déployerAu jugéQuality gate explicite
Évolution de la detteImpression généraleMesures par version
Où vit le codeSur votre forgeSur votre forge et votre VPS

Préparer le serveur

Prévoyez un VPS Ubuntu 24.04 avec 4 Go de RAM et 2 vCPU au minimum : SonarQube fait tourner trois processus Java — le serveur web, le moteur de calcul qui traite les analyses et un Elasticsearch embarqué. Installez Docker et le plugin Compose.

Deux réglages du système comptent. Elasticsearch réclame vm.max_map_count à 524288 au moins : réglez-le sur l'hôte avec sysctl -w vm.max_map_count=524288 et rendez-le permanent dans /etc/sysctl.d/99-sonarqube.conf. Et SonarQube refuse de démarrer quand moins de 10 % du disque est libre : gardez de la marge.

Installer SonarQube avec Docker Compose

  1. Préparer le dossier et le fichier .env

    Le fichier porte le mot de passe de la base PostgreSQL.

    mkdir -p /opt/sonarqube && cd /opt/sonarqube
    cat > .env <<EOF
    DB_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. Écrire le fichier docker-compose.yml

    Deux services : PostgreSQL et SonarQube. Le port n'est publié que sur la boucle locale : seul nginx sera exposé à Internet.

    services:
      db:
        image: postgres:17.12-alpine
        restart: unless-stopped
        environment:
          POSTGRES_DB: sonar
          POSTGRES_USER: sonar
          POSTGRES_PASSWORD: "${DB_PASSWORD}"
        volumes:
          - sonarqube-db:/var/lib/postgresql/data
    
      sonarqube:
        image: sonarqube:26.11.0.134175-community
        restart: unless-stopped
        depends_on: [db]
        environment:
          SONAR_JDBC_URL: "jdbc:postgresql://db:5432/sonar"
          SONAR_JDBC_USERNAME: sonar
          SONAR_JDBC_PASSWORD: "${DB_PASSWORD}"
          SONAR_TELEMETRY_ENABLE: "false"
          SONAR_ES_BOOTSTRAP_CHECKS_DISABLE: "true"
        ulimits:
          nofile: { soft: 131072, hard: 131072 }
          nproc: { soft: 8192, hard: 8192 }
        ports:
          - "127.0.0.1:9000:9000"
        volumes:
          - sonarqube-data:/opt/sonarqube/data
          - sonarqube-extensions:/opt/sonarqube/extensions
          - sonarqube-logs:/opt/sonarqube/logs
    
    volumes:
      sonarqube-db: {}
      sonarqube-data: {}
      sonarqube-extensions: {}
      sonarqube-logs: {}
  3. Démarrer et vérifier

    Le premier démarrage crée le schéma de la base et les index de recherche : comptez deux à cinq minutes. L'état doit passer à UP.

    docker compose up -d
    docker compose logs -f sonarqube    # attendre « SonarQube is operational »
    curl -s http://127.0.0.1:9000/api/system/status
  4. Remplacer le mot de passe d'usine

    Le compte admin est créé avec le mot de passe admin. Remplacez-le avant de publier l'instance. SonarQube exige au moins 12 caractères avec une majuscule, une minuscule, un chiffre et un caractère spécial.

    NEW='<votre-mot-de-passe>'
    curl -fsS -u admin:admin -X POST http://127.0.0.1:9000/api/users/change_password \
      --data-urlencode login=admin --data-urlencode previousPassword=admin \
      --data-urlencode "password=$NEW"
    curl -s -u admin:admin http://127.0.0.1:9000/api/authentication/validate   # {"valid":false}

Ne publiez jamais une instance en admin/admin

Tant que le mot de passe d'usine est actif, le premier venu qui trouve votre adresse devient administrateur et lit tout votre code. Remplacez-le avant d'ouvrir le reverse proxy, puis créez un compte nominatif par développeur dans Administration, Sécurité, Utilisateurs. La connexion est exigée par défaut pour tout consulter : laissez ce réglage actif.

Publier SonarQube en HTTPS derrière nginx

Obtenez un certificat avec certbot, puis déclarez un server block qui transmet l'en-tête X-Forwarded-Proto :

server {
    listen 443 ssl;
    server_name sonarqube.example.com;
    ssl_certificate     /etc/letsencrypt/live/sonarqube.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/sonarqube.example.com/privkey.pem;
    client_max_body_size 50m;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
    }
}

Dans Administration, Configuration, Général, renseignez ensuite l'URL du serveur (https://sonarqube.example.com) : SonarQube l'écrit dans ses liens, ses notifications et ses webhooks.

Analyser un premier projet

Dans Mon compte, Sécurité, générez un jeton de type Global Analysis Token. Depuis la racine d'un projet, lancez le scanner officiel en conteneur, sans rien installer sur votre poste :

docker run --rm \
  -e SONAR_HOST_URL=https://sonarqube.example.com \
  -e SONAR_TOKEN=<jeton> \
  -v "$PWD:/usr/src" \
  sonarsource/sonar-scanner-cli \
  -Dsonar.projectKey=mon-projet -Dsonar.sources=.

Le projet apparaît dans SonarQube avec ses défauts, sa dette et le verdict du quality gate. Pour un projet Java construit avec Maven ou Gradle, utilisez plutôt le plugin du build, qui lit les classes compilées.

Bloquer un pipeline sur le quality gate

Enregistrez SONAR_HOST_URL et SONAR_TOKEN dans les secrets du dépôt. Avec sonar.qualitygate.wait=true, le scanner attend le verdict et échoue si le quality gate est rouge : l'étape de déploiement qui suit ne s'exécute pas.

# .github/workflows/sonarqube.yml
name: sonarqube
on:
  push:
    branches: [main]
jobs:
  analyse:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Analyse SonarQube
        run: |
          docker run --rm -e SONAR_HOST_URL -e SONAR_TOKEN -v "$PWD:/usr/src" \
            sonarsource/sonar-scanner-cli \
            -Dsonar.projectKey=${{ github.event.repository.name }} \
            -Dsonar.qualitygate.wait=true
        env:
          SONAR_HOST_URL: ${{ secrets.SONAR_HOST_URL }}
          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

Le principe est le même sur GitLab CI, Jenkins ou Woodpecker : une étape qui lance le scanner avec ces deux variables.

Sauvegarde et mise à jour

Les résultats vivent dans PostgreSQL ; les plugins ajoutés vivent dans le volume sonarqube-extensions. Les index de recherche se reconstruisent seuls au démarrage et n'ont pas besoin d'être sauvegardés.

cd /opt/sonarqube
docker compose exec -T db pg_dump -U sonar sonar | gzip > sonar-$(date +%F).sql.gz
docker run --rm -v sonarqube_sonarqube-extensions:/src -v "$PWD:/dst" alpine \
  tar czf /dst/extensions-$(date +%F).tar.gz -C /src .

Pour mettre à jour, sauvegardez d'abord, changez le tag de l'image, puis docker compose pull && docker compose up -d. Si SonarQube demande une migration de base, ouvrez https://votre-domaine/setup et lancez-la.

SonarQube en un clic sur ServOrbit

Le Marketplace ServOrbit installe exactement cette pile : image officielle SonarQube Community Build et PostgreSQL, port publié sur 127.0.0.1 uniquement, mot de passe d'usine du compte admin remplacé dès le premier démarrage, URL du serveur déclarée et HTTPS configuré sur votre domaine ou sur le sous-domaine gratuit du VPS. Le mot de passe administrateur s'affiche dans votre espace client.

Partager cet articleservorbit.com/ma-fr/blog/self-host-sonarqube-vps

Votre analyse de code sur votre VPS

Prix HT affichés avec leur renouvellement.