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 seule | Avec SonarQube sur votre VPS | |
|---|---|---|
| Défauts répétitifs | Dépend de l'attention du relecteur | Relevés à chaque analyse |
| Failles connues | Repérées si on les connaît | Règles de sécurité appliquées partout |
| Décision de déployer | Au jugé | Quality gate explicite |
| Évolution de la dette | Impression générale | Mesures par version |
| Où vit le code | Sur votre forge | Sur 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
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É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: {}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/statusRemplacer le mot de passe d'usine
Le compte
adminest créé avec le mot de passeadmin. 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.
servorbit.com/ma-fr/blog/self-host-sonarqube-vps
