VibeCoderzVibeCoderz
Все статьи
2026/10/0110 мин чтения

SonarQube в Docker: установка через docker compose и Helm за 15 минут

Содержание (10)+

SonarQube в Docker поднимается двумя способами: через docker compose с PostgreSQL на одном сервере или через официальный Helm-чарт в Kubernetes. Для рабочей установки нужна внешняя база, встроенная H2 годится только для проверки. Ниже compose-файл, команды Helm, проверка порта 9000 и таблица ошибок первого запуска.

TL;DR: SonarQube Community Build 26.9 запускается одним compose-файлом с PostgreSQL: порт 9000, три тома и три настройки ядра Linux. В Kubernetes его ставит официальный Helm-чарт 2026.4.1 с запросом памяти 2048M и лимитом 6144M. В статье файлы, команды, проверка запуска и разбор частых ошибок.

Что нужно для SonarQube в Docker до первого запуска?

Нужен Linux-сервер с Docker и Compose, запас оперативной памяти и три настройки ядра: vm.max_map_count, лимиты файлов и потоков. Без них встроенный Elasticsearch не стартует.

Внутри него работает встроенный Elasticsearch, поэтому хост обязан пройти production-проверки этого движка. Документация Sonar на сентябрь 2026 требует vm.max_map_count не ниже 524288, fs.file-max не ниже 131072, а пользователю процесса 131072 открытых файла и 8192 потока. Для Docker эти значения берутся с хоста (документация Sonar).

На свежем сервере vm.max_map_count обычно стоит 65530, это значение по умолчанию для ядра Linux. Проверьте текущие цифры и поднимите их:

sysctl vm.max_map_count fs.file-max
sudo sysctl -w vm.max_map_count=524288
sudo sysctl -w fs.file-max=131072

Команда sysctl -w действует до перезагрузки. Чтобы значения пережили рестарт, положите две строки в /etc/sysctl.d/99-sonarqube.conf: vm.max_map_count=524288 и fs.file-max=131072.

ПараметрМинимумКак проверить
vm.max_map_count524288sysctl vm.max_map_count
fs.file-max131072sysctl fs.file-max
Открытые файлы (nofile)131072ulimit -n
Потоки (nproc)8192ulimit -u
Изображение

Сколько памяти нужно серверу?

Точной цифры "минимум для всех" у Sonar нет, зато есть ориентиры. В официальном Helm-чарте запрос памяти по умолчанию 2048M, лимит 6144M. Автор сборки SonarQube для 1С советует держать на хосте не меньше 6 ГБ свободной памяти (репозиторий Daabramov).

Отсюда прямой вывод: на самом маленьком VPS с 1 ГБ SonarQube не заведется. Берите сервер минимум с 4 ГБ, а лучше с 8. Тарифы с оплатой в рублях есть, например, у Timeweb.

Как поднять SonarQube через docker compose с PostgreSQL?

Создайте папку, положите туда файл .env с паролем базы и docker-compose.yml из этой статьи, затем выполните docker compose up -d. Интерфейс откроется на порту 9000, когда закончит первичную инициализацию.

Официальный образ sonarqube на Docker Hub объединяет SonarQube Server и Community Build, слушает порт 9000 и хранит данные в каталогах data, logs и extensions. Compose-файл из двух сервисов, SonarQube и PostgreSQL 16, с тремя именованными томами и фиксированным тегом образа даст воспроизводимую установку на одном сервере.

Связка из двух контейнеров, SonarQube и PostgreSQL, подходит для установки на одном сервере. Официальный образ sonarqube на Docker Hub содержит и SonarQube Server, и Community Build. Контейнер слушает порт 9000, а данные лежат в трех каталогах: data, logs и extensions (Docker Hub).

Шаг 1. Какие файлы создать?

Сначала пароль базы. Он лежит в .env, чтобы не попасть в репозиторий вместе с compose-файлом:

mkdir sonarqube && cd sonarqube
echo 'SONAR_DB_PASSWORD=замените-на-свой-пароль' > .env

Теперь docker-compose.yml. Тег образа зафиксирован: Community Build выходит каждый месяц, а latest при пересоздании контейнера тихо утащит вас на новую версию.

<!-- ВНИМАНИЕ РЕДАКТОРУ: синтаксис файла проверен командой docker compose config, но полный запуск на живом Docker-хосте перед публикацией сделать обязательно. Сверьте тег образа на https://hub.docker.com/_/sonarqube/tags -->

services:
  db:
    image: postgres:16
    container_name: sonarqube-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: sonar
      POSTGRES_PASSWORD: ${SONAR_DB_PASSWORD}
      POSTGRES_DB: sonar
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U sonar -d sonar"]
      interval: 10s
      timeout: 5s
      retries: 10

  sonarqube:
    image: sonarqube:26.9.0.129388-community
    container_name: sonarqube
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "9000:9000"
    environment:
      SONAR_JDBC_URL: jdbc:postgresql://db:5432/sonar
      SONAR_JDBC_USERNAME: sonar
      SONAR_JDBC_PASSWORD: ${SONAR_DB_PASSWORD}
    ulimits:
      nofile:
        soft: 131072
        hard: 131072
      nproc: 8192
    volumes:
      - sonarqube_data:/opt/sonarqube/data
      - sonarqube_logs:/opt/sonarqube/logs
      - sonarqube_extensions:/opt/sonarqube/extensions

volumes:
  postgres_data:
  sonarqube_data:
  sonarqube_logs:
  sonarqube_extensions:

Три строки здесь решают больше всего проблем. depends_on с service_healthy не дает SonarQube стартовать раньше базы. Блок ulimits задает лимиты файлов и потоков внутри контейнера. Именованные тома избавляют от возни с правами на каталоги хоста.

Шаг 2. Как запустить контейнеры?

Одна команда поднимает обе службы в фоне. Первый запуск скачивает образы, это примерно гигабайт, так что время зависит от канала.

docker compose up -d
docker compose logs -f sonarqube

В логах ищите строку SonarQube is operational. Пока ее нет, он занят созданием таблиц и индексов Elasticsearch, и открывать страницу рано.

Изображение

Почему для SonarQube нельзя оставлять встроенную H2?

Образ по умолчанию использует встроенную базу H2, и Docker Hub прямо пишет, что она не подходит для рабочей установки. Для реальных проектов подключайте внешний PostgreSQL.

Встроенная база H2 лежит в каталоге data и по документации Docker Hub не подходит для рабочей установки. К одной схеме базы допускается ровно один экземпляр сервера. Внешний PostgreSQL сохраняет историю анализов отдельно от контейнера и позволяет делать обычные бэкапы через pg_dump.

Встроенная H2 хранится в каталоге data рядом с индексами Elasticsearch. Для демо она удобна: docker run -p 9000:9000 sonarqube:community и через минуту у вас интерфейс. Но Sonar называет такую базу непригодной для production, и у этого есть практический смысл.

Данные анализов копятся месяцами. Потеряв том data, вы теряете историю всех проектов сразу. С PostgreSQL история живет в базе, которую можно бэкапить обычным pg_dump и переносить на другой сервер.

Есть еще одно правило из документации. К одной схеме базы может подключаться только один экземпляр SonarQube. В Docker Swarm или Kubernetes два экземпляра на одной схеме повредят данные, и защиты от этого нет.

Устаревший совет из видео про SonarQube 7.1: править sonar.properties и раскомментировать строку PostgreSQL. В Docker это не нужно. Хватает трех переменных SONAR_JDBC_*, как в файле выше.

Изображение

Как установить SonarQube в Kubernetes через Helm?

Добавьте репозиторий SonarSource, создайте namespace и выполните helm upgrade --install с параметром community.enabled=true. Базу подключайте через jdbcOverwrite, встроенная H2 в чарте только для теста.

Официальный Helm-чарт SonarSource версии 2026.4.1 ставит Community Build при community.enabled=true. Запрос памяти по умолчанию составляет 2048M, лимит 6144M. С версии 2026.1.0 чарт не содержит собственного PostgreSQL, поэтому рабочую базу подключают через параметры jdbcOverwrite.

Официальный чарт лежит в репозитории SonarSource, на Artifact Hub его версия 2026.4.1. По умолчанию он ставит SonarQube Community Build 26.8.0.126808, а более свежую сборку задает параметр community.buildNumber (Artifact Hub).

Шаг 1. Какие команды выполнить?

Для Community Build включите community.enabled, а параметр edition не указывайте вовсе. Пасскод мониторинга нужен для проб живости.

helm repo add sonarqube https://SonarSource.github.io/helm-chart-sonarqube
helm repo update
kubectl create namespace sonarqube
export MONITORING_PASSCODE="придумайте-пасскод"
helm upgrade --install -n sonarqube sonarqube sonarqube/sonarqube \
  --set community.enabled=true \
  --set monitoringPasscode=$MONITORING_PASSCODE

Так вы получите рабочий стенд на встроенной H2. Для теста этого достаточно. Для постоянной работы переходите к файлу значений.

Шаг 2. Как подключить PostgreSQL и задать память?

Начиная с версии чарта 2026.1.0 зависимость от PostgreSQL из чарта убрана, база внешняя. Видео про Helm, где Postgres создавался вместе со SonarQube, снято на чарте Bitnami. С официальным чартом Sonar так уже не работает.

Сохраните values.yaml и запустите установку с флагом -f values.yaml:

community:
  enabled: true
monitoringPasscode: "придумайте-пасскод"

jdbcOverwrite:
  enabled: true
  jdbcUrl: "jdbc:postgresql://postgres.example.internal:5432/sonar"
  jdbcUsername: "sonar"
  jdbcSecretName: "sonarqube-db-secret"
  jdbcSecretPasswordKey: "password"

resources:
  requests:
    memory: 6144M
  limits:
    memory: 6144M

Чарт советует ставить requests и limits памяти одинаковыми, чтобы память стала гарантированным ресурсом. Значения по умолчанию, 2048M и 6144M, рассчитаны на три редакции сразу, и для Community Build их можно снижать по своей нагрузке. В продакшене еще отключают initSysctl.enabled и настраивают vm.max_map_count на уровне узлов.

Изображение

Как проверить запуск на порту 9000 и сменить пароль?

Откройте http://адрес-сервера:9000 или запросите /api/system/status: ответ со статусом UP значит, что сервер готов. Войдите как admin с паролем admin и сразу задайте новый пароль.

Готовность сервера показывает запрос к /api/system/status: статус UP означает, что интерфейс на порту 9000 открыт. Логин и пароль по умолчанию admin и admin, при первом входе SonarQube просит новый пароль. В Helm-чарте пароль администратора выставляет отдельная задача setAdminPassword.

Проверку удобно делать из терминала, пока страница еще не открылась. Статус STARTING означает, что сервер грузится, UP означает готовность.

docker compose ps
curl -s http://localhost:9000/api/system/status

В Kubernetes порт пробрасывается локально командой kubectl port-forward -n sonarqube svc/sonarqube-sonarqube 9000:9000. Имя сервиса зависит от имени релиза, сверьтесь с выводом kubectl get svc -n sonarqube.

Логин по умолчанию admin, пароль admin. Новый пароль система потребует при первом входе, не откладывайте это. Учтите, что чарт Helm выставляет пароль администратора через отдельную задачу, и значение по умолчанию у него тоже публичное. Задайте свое через setAdminPassword.newPassword или секрет.

Автор видео про Helm выяснил на практике: смена пароля в values после первой установки не подхватывается. Меняйте пароль в интерфейсе.

Изображение

Почему SonarQube не запускается с первого раза?

Чаще всего виноваты четыре причины: низкий vm.max_map_count, нехватка памяти, права на каталоги и база, которая не успела подняться. Диагностика начинается с docker compose logs sonarqube.

Четыре причины отказа при первом запуске повторяются чаще остальных: vm.max_map_count ниже 524288, нехватка памяти, закрытая для записи файловая система и база, не успевшая подняться. Начинать диагностику стоит с команды docker compose logs sonarqube, где причина обычно названа прямым текстом.

Ошибки первого запуска повторяются от сервера к серверу. Логи почти всегда называют причину прямым текстом, надо только дойти до нужной строки.

Симптом в логах или поведенииПричинаЧто делать
Контейнер падает, Elasticsearch жалуется на bootstrap checksvm.max_map_count ниже 524288Поднять значение на хосте и перезапустить контейнер
Контейнер уходит в рестарт, в dmesg упоминается OOMНе хватило памяти хостуОсвободить память или взять сервер побольше
Ошибки записи в data, logs или /tmpНет прав на каталогиИспользовать именованные тома, не закрывать /tmp от записи
Ошибка подключения к базе при стартеSonarQube стартовал раньше PostgreSQLДобавить healthcheck и depends_on с service_healthy
Образ не скачиваетсяDocker Hub недоступен из вашей сетиЗеркало реестра провайдера или собственный registry

Про /tmp есть нюанс. Начиная с версии 2026.1 инициализация Elasticsearch 8.x создает сокет-файлы в жестко заданном каталоге /tmp/.java_pid<PID>. Если вы запускаете контейнер с защищенной файловой системой, оставьте /tmp доступным на чтение и запись.

Максим: «Мог просто засесть до пяти ночи и править одну функцию, которая не работала. В моменте уже хотелось все закрыть. Но я понимал, что это можно решить и нужно решить, чтобы идти дальше.»

С SonarQube похожая история. Основное время уходит на sysctl, память и права, зато потом сервер работает без вмешательства. Если такие задачи повторяются, посмотрите готового ИИ-агента для DevOps, а compose-файл перед запуском можно показать Claude Code или другой AI IDE из каталога.

Изображение

Какие у SonarQube в Docker честные ограничения?

SonarQube тяжелый: Java, Elasticsearch и база требуют много памяти. На маленьком VPS он не запустится, а обновления Community Build выходят каждый месяц и требуют бэкапа.

SonarQube тянет Java, Elasticsearch и базу, поэтому на сервере с 1 ГБ памяти он не запустится. Community Build обновляется ежемесячно, а одна схема базы обслуживает только один экземпляр. Перед каждым обновлением фиксируйте тег образа и делайте дамп PostgreSQL командой pg_dump.

Про плюсы написано много, поэтому вот минусы без прикрас. Ему нужен запас памяти: чарт по умолчанию резервирует 2048M. Один экземпляр работает с одной схемой базы, а кластер предлагает только коммерческая Data Center Edition.

Community Build выходит ежемесячно. Зафиксируйте тег образа и перед обновлением сделайте бэкап:

docker compose exec -T db pg_dump -U sonar sonar > sonar-backup.sql

Community Build покрывает 21 язык и фреймворк, коммерческий SonarQube Server анализирует 30+ языков и дает продвинутый анализ безопасности (данные с Docker Hub). Если нужен глубокий поиск уязвимостей, Community не хватит.

Для российских команд добавляется сетевая часть. Если Docker Hub работает нестабильно, используйте зеркало реестра вашего провайдера или собственный registry. VPN-сервисы мы не рекомендуем. Начиная с чарта 2026.5.0 в нем нет встроенного ingress-nginx, поэтому для доступа снаружи ставьте свой ingress-контроллер или Gateway API.

Что выбрать, docker compose или Helm?

Compose подходит для одного сервера и команды до нескольких десятков человек. Helm нужен, если у вас уже есть Kubernetes и требования к отказоустойчивости и мониторингу.

Docker compose подходит для одного сервера и небольшой команды, установка занимает около 15 минут. Helm оправдан при готовом Kubernetes-кластере, внешней PostgreSQL и мониторинге через Prometheus. Обе схемы используют один и тот же образ sonarqube и одну и ту же базу.

Выбор решает инфраструктура, которая у вас уже есть. Поднимать Kubernetes ради одной этой задачи нет смысла, а вот в существующий кластер он встает штатным чартом.

Критерийdocker composeHelm в Kubernetes
Время установки (ориентир)около 15 минут15-30 минут при готовом кластере
База данныхКонтейнер PostgreSQL рядомВнешний PostgreSQL через jdbcOverwrite
ОбновлениеСменить тег, docker compose up -dhelm upgrade с новой версией чарта
МониторингРучной, через логиPrometheus-экспортер и PodMonitor в чарте
Кому подходитНебольшая команда, один серверКоманда с Kubernetes и DevOps

Итог простой. Начинайте с compose, если кластера нет. Уходите в Helm, когда сервер должен жить рядом с остальной инфраструктурой. Обе схемы работают с одной и той же внешней PostgreSQL, так что переезд потом не сломает историю анализов.

Изображение

Частые вопросы про установку SonarQube в Docker

Сколько времени занимает установка SonarQube в Docker?
Сама установка укладывается в 15 минут: настройки ядра, два файла и загрузка образов. Первый старт занимает еще несколько минут, пока сервер создает таблицы и индексы Elasticsearch.

Какой логин и пароль стоят по умолчанию?
Логин admin, пароль admin. При первом входе система потребует сменить пароль. В Helm-чарте пароль администратора выставляет отдельная задача, поэтому задайте свой через setAdminPassword.

Можно ли обойтись без PostgreSQL?
Можно, образ по умолчанию работает на встроенной H2. Но Docker Hub называет ее непригодной для production. Для тестов на ноутбуке подойдет, для рабочего сервера подключайте PostgreSQL.

Почему контейнер падает сразу после старта?
Почти всегда из-за vm.max_map_count ниже 524288 или нехватки памяти. Откройте docker compose logs sonarqube: там будет строка про bootstrap checks Elasticsearch или сообщение об убитом процессе.

Какую версию образа выбрать?
Для сообщества берите фиксированный тег вида 26.9.0.129388-community, а не latest. Для коммерческих редакций Docker Hub предлагает LTA-теги, например 2026.5-lta-developer. Актуальные теги смотрите на странице образа.

Чем Community Build отличается от SonarQube Server?
Community Build бесплатный, выходит ежемесячно и покрывает 21 язык и фреймворк. Коммерческий SonarQube Server анализирует 30+ языков и дает продвинутый анализ безопасности. Оба варианта лежат в одном образе sonarqube на Docker Hub.

Как обновить версию в Docker?
Сделайте pg_dump, поменяйте тег образа в compose-файле и выполните docker compose up -d. Для Kubernetes поменяйте версию в values и запустите helm upgrade. Перед обновлением прочитайте инструкцию Sonar по вашему пути версий.

Что дальше?

Сервер работает, теперь подключайте проекты через сканер и настраивайте Quality Gate. Свежие обзоры инструментов для разработки собраны в каталоге AI-инструментов VibeCoderz. Если застряли на настройке под свой стек, запишитесь на консультацию к Максиму.

Обновлено: октябрь 2026. Версии образа и чарта указаны по состоянию на 29 сентября 2026.


Автор

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

2026/10/01

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
All Posts

Читать далее

📄 Статья

Gemini 4 Neon обзор 2026, где она обходит Claude и 8 рабочих промптов

Gemini 4 Neon - модель Google среднего-верхнего класса, вышедшая 18 ноября 2026 года по цене $3 за миллион входных и $15 за миллион выходных токенов. Она заняла первое место на юридическом Legal Research Bench и налоговом Tax Agent Bench от Vals AI и…

2026/11/1914 мин
📄 Статья

GPT-6.2 Astra как пользоваться в 2026, цены, тесты и 8 промптов

GPT-6.2 Astra - флагманская модель OpenAI, вышедшая 17 ноября 2026 года: стоит $8 за миллион входных и $40 за миллион выходных токенов и работает в ChatGPT Work, Codex, API и GitHub Copilot. По индексу Artificial Analysis она вторая в мире (62 балла)…

2026/11/1812 мин
📄 Статья

GPT-6.2 Sol обзор 2026 модель за $2, ловушка low и 8 промптов

GPT-6.2 Sol - рабочая модель OpenAI на каждый день, вышедшая 17 ноября 2026 года вместе с флагманом Astra. Цена осталась как у GPT-6.1 Sol ($2 за миллион входных и $10 за миллион выходных токенов), а задача стала дешевле и в три раза быстрее: $1,01 и…

2026/11/1810 мин
📄 Статья

Нейросети для бухгалтера и 10 ИИ-инструментов для учета в 2026

Нейросети для бухгалтера 2026: топ-10 ИИ-инструментов учета

2026/10/1212 мин
📄 Статья

ИИ для HR в 2026, 9 нейросетей для подбора и найма персонала

ИИ для HR в 2026: 9 нейросетей для подбора и найма персонала

2026/10/1212 мин
📄 Статья

Нейросети для маркетинга, 10 ИИ-инструментов маркетолога в 2026

Лучшая нейросеть для маркетинга зависит от задачи. Тексты и аналитику тянут ChatGPT, Claude и Gemini, а картинки для рекламы быстрее всего дают Kandinsky, Midjourney и Nano Banana. Без VPN и зарубежной карты сегодня работают GigaChat, Алиса AI, Kandi…

2026/10/1211 мин