MongoDB
MongoDB install: как установить MongoDB и проверить первый запуск
Если вы ищете mongodb install, вам нужен не просто файл для скачивания, а рабочая цепочка: установить MongoDB Community Server, запустить серверный процесс mongod, открыть клиент mongosh и проверить, что база отвечает. Самый надежный источник установки — официальная документация MongoDB под вашу операционную систему, потому что команды для Ubuntu, Windows и macOS отличаются и со временем меняются
Короткий результат, к которому нужно прийти:
mongosh
db.runCommand({ ping: 1 })
Если MongoDB вернула ok: 1, сервер работает
Что именно устанавливается
В MongoDB важно различать несколько компонентов
mongod — сервер базы данных. Он хранит данные, слушает порт, принимает подключения и выполняет запросы
mongosh — shell-клиент. Через него вы подключаетесь к серверу и выполняете команды
MongoDB Compass — графический интерфейс. Он удобен для новичков, но сам по себе не заменяет сервер
MongoDB Database Tools — отдельные утилиты для импорта, экспорта, дампов и восстановления
Для первого запуска обычно достаточно Community Server и mongosh. Compass можно поставить позже, когда понадобится визуально смотреть коллекции
Установка на Windows
Для Windows берите MSI-установщик MongoDB Community Server с официального сайта MongoDB. В установщике лучше оставить вариант установки как Windows Service: тогда MongoDB будет запускаться через службу, а не как ручной процесс в консоли
Базовый порядок такой:
- Откройте официальную инструкцию установки MongoDB Community Edition для Windows.
- Скачайте MSI-пакет под вашу версию Windows.
- Запустите установщик от имени пользователя с правами установки программ.
- Оставьте установку MongoDB как Windows Service.
- Дождитесь завершения установки и проверьте версии.
mongod --version
mongosh --version
Если mongosh не находится, установите MongoDB Shell отдельно или проверьте PATH. Это частая ситуация: сервер поставился, но shell недоступен из терминала
Проверка службы:
Get-Service *Mongo*
Если служба есть, но не запущена:
Start-Service MongoDB
Установка на Ubuntu
Для Ubuntu не стоит копировать старую команду из случайной статьи. Репозиторий MongoDB зависит от версии Ubuntu и версии MongoDB. Официальная инструкция обычно включает добавление ключа, подключение репозитория, установку пакета mongodb-org и запуск службы
Общий вид установки после добавления официального репозитория:
sudo apt update
sudo apt install -y mongodb-org
Запуск:
sudo systemctl start mongod
Проверка статуса:
sudo systemctl status mongod
Автозапуск:
sudo systemctl enable mongod
Если systemctl пишет, что службы mongod нет, значит установка не завершилась или пакет поставился не из того репозитория. Вернитесь к официальной инструкции именно для вашей версии Ubuntu
Установка на macOS
На macOS удобный путь для локальной разработки — Homebrew. MongoDB поддерживает установку через tap mongodb/brew. После установки сервер можно запускать как сервис Homebrew
Проверьте, что Homebrew установлен:
brew --version
После установки MongoDB проверьте список сервисов:
brew services list
Запуск и проверка зависят от имени установленного пакета, поэтому смотрите актуальное имя в официальной инструкции и выводе brew services list
Первая проверка через mongosh
Откройте shell:
mongosh
Выполните ping:
db.runCommand({ ping: 1 })
Затем создайте тестовую базу и документ:
use shop
db.products.insertOne({
title: "Курс по MongoDB",
price: 1900,
inStock: true
})
db.products.find({ inStock: true })
MongoDB создаст базу shop и коллекцию products при первой записи. До вставки документа пустая база может не отображаться в списке, и это нормально
Как понять, что установка прошла правильно
Проверяйте не один признак, а несколько
| Что проверить | Команда | Что должно быть |
|---|---|---|
| Сервер установлен | mongod --version |
версия MongoDB Server |
| Shell установлен | mongosh --version |
версия MongoDB Shell |
| Служба работает | systemctl status mongod или Get-Service Mongo |
статус running/active |
| Сервер отвечает | db.runCommand({ ping: 1 }) |
ok: 1 |
| Запись работает | insertOne() и find() |
документ появляется в выборке |
Частые ошибки установки
mongosh: command not found
Shell не установлен или не добавлен в PATH. Установите MongoDB Shell отдельно по официальной инструкции или перезапустите терминал после установки
ServerSelectionTimeoutError
Клиент не может подключиться к серверу. Проверьте, запущен ли mongod, не занят ли порт 27017, не изменен ли порт в конфиге и не блокирует ли подключение firewall
Data directory not found
MongoDB не может найти папку для данных. На Windows это может быть проблема пути, на Linux — прав доступа к каталогу. Смотрите лог запуска, там обычно указан конкретный путь
Установка на Ubuntu падает из-за репозитория
Чаще всего используется инструкция не под вашу версию Ubuntu. Например, команды для одной LTS-версии не всегда подходят другой. Не подменяйте репозиторий наугад: откройте официальную страницу установки и выберите точную версию
Что делать после установки
После первого запуска не переходите сразу к сложной архитектуре. Нормальный учебный путь такой:
- Создать базу и коллекцию.
- Вставить один документ.
- Найти документ через
find(). - Обновить поле через
updateOne(). - Удалить тестовую запись через
deleteOne(). - Открыть эту же базу в MongoDB Compass.
- Подключить проект на Python, Node.js или другом языке.
Так вы поймете, что MongoDB не просто установлена, а реально работает в вашем окружении
Что почитать дальше по MongoDB
Если нужен общий маршрут по теме, откройте рубрику MongoDB. Для соседних задач пригодятся эти разборы:
- MongoDB install Ubuntu: как установить и проверить запуск
- Как установить MongoDB Community Server и проверить, что база работает
- Failed to start MongoDB database server: что проверить
- MongoDB aggregate: как написать первый aggregation-запрос