Step 1 — Download the MongoDB MSI Installer Package
Head over here and download the current version of MongoDB. Make sure you select MSI as the package you want to download.
Step 2 — Install MongoDB with the Installation Wizard
A. Make sure you are logged in as a user with Admin privileges. Then navigate to your downloads folder and double click on the .msi package you just downloaded. This will launch the installation wizard.
B. Click Next to start installation.
C. Accept the licence agreement then click Next.
D. Select the Complete setup.
E. Select “Run service as Network Service user” and make a note of the data directory, we’ll need this later.
F. We won’t need Mongo Compass, so deselect it and click Next.
G. Click Install to begin installation.
F. Hit Finish to complete installation.
Step 3— Create the Data Folders to Store our Databases
A. Navigate to the C Drive on your computer using Explorer and create a new folder called data here.
B. Inside the data folder you just created, create another folder called db.
Step 4 — Setup Alias Shortcuts for Mongo and Mongod
Once installation is complete, we’ll need to set up MongoDB on the local system.
A. Open up your Hyper terminal running Git Bash.
B. Change directory to your home directory with the following command:
C. Here, we’re going to create a file called .bash_profile using the following command:
touch .bash_profile
D. Open the newly created .bash_profile with vim using the following command:
vim .bash_profile
E. In vim, hit the I key on the keyboard to enter insert mode.
F. In your explorer go to C → Program Files → MongoDB → Server
Now you should see the version of your MongoDB.
G. Paste in the following code into vim, make sure your replace the 4.0 with your version that you see in explorer
alias mongod="/c/Program\ files/MongoDB/Server/4.0/bin/mongod.exe"
alias mongo="/c/Program\ Files/MongoDB/Server/4.0/bin/mongo.exe"
F. Hit the Escape key on your keyboard to exit the insert mode. Then type
to save and exit Vim.
Step 5 — Verify That Setup was Successful
A. Close down the current Hyper terminal and quit the application.
B. Re-launch Hyper.
C. Type the following commands into the Hyper terminal:
mongo --version
Once you’ve hit enter, you should see something like this:
This means that you have successfully installed and setup MongoDB on your local system!
If you see something that looks like bash mongo command not found, then make sure you check back at all the steps above and follow it step-by-step making sure there are no typos and you haven’t missed any of the steps.
Как установить mongodb на windows 10
Официальный сайт предоставляет пакеты дистрибутивов для различных платформ: Windows, Linux, MacOS, Solaris. И каждой платформы доступно несколько дистрибутивов. Причем есть два вида серверов — бесплатный Community и платный Enterprise. В данном руководстве будем использовать бесплатную версию Community.
Для установки MongoDB загрузим один распространяемых пакетов с официального сайта https://www.mongodb.com/try/download/community.
Для загрузки всех необходимых файлов выберем нужную операционную систему и подходящий тип пакета. Рассмотрим на примере установки на ОС Windows.
MongoDB можно загрузить в ряде вариантов. Так, для Windows доступна загрузка установщика msi и также доступна загрузка архива zip . В реальности нам достаточно загрузить zip-архив и распаковать в нужной нам папке. Поэтому выберем этот вариант загрузки (хотя также можно выбрать вариант установщика msi ):
Если до установки уже была установлена более ранняя версия MongoDB, то ее необходимо удалить.
После загрузки архивного пакета распакуем его в папку C:\mongodb .
Если после установки мы откроем папку bin в распакованном архиве ( C:\mongodb\bin ), то сможем найти там кучу приложений, которые выполняют определенную роль. Вкратце рассмотрим их.
- mongod : сервер баз данных MongoDB. Он обрабатывает запросы, управляет форматом данных и выполняет различные операции в фоновом режиме по управлению базами данных
- mongos : служба маршрутизации MongoDB, которая помогает обрабатывать запросы и определять местоположение данных в кластере MongoDB
Создание каталога для БД и запуск MongoDB
После установки надо создать на жестком диске каталог, в котором будут находиться базы данных MongoDB.
В ОС Windows по умолчанию MongoDB хранит базы данных по пути C:\data\db , поэтому, если вы используете Windows, вам надо создать соответствующий каталог.
Если же возникла необходимость использовать какой-то другой путь к файлам, то его можно передать при запуске MongoDB во флаге —dbpath .
Итак, после создания каталога для хранения БД можно запустить сервер MongoDB. Сервер представляет приложение mongod , которое находится в каталоге bin в папке сервера. Для этого запустим терминал/командную строку и там введем соответствующие команды. Для ОС Windows это будет выглядеть так:
Командная строка отобразит нам ряд служебной информации, например, что сервер запускается на localhost на порту 27017.
И после удачного запуска сервера мы сможем производить операции с бд через клиент.
Установка клиента Mongosh
Выше мы установили сервер MongoDb. Однако для работы с сервером нам нужен клиент. Наиболее простым клиентом в данном случае является MongoDB Shell или mongosh — консольная оболочка для отправки запросов к серверу, которая также предоставляется непосредственно компанией MongoDB.
Здесь опять же мы можем выбрать версии клиента для разных операционных систем. Для Windows пакет клиента доступен в виде архива zip. Загрузим этот пакет и распакуем его в папку C:\mongosh .
Если в распакованном архиве мы зайдем в папку bin (то есть C:\mongosh\bin ), то обнаружим там консольную утилиту mongosh , которая будет применяться для работы с сервером MongoDB:
Подключение к серверу из клиента
Используем выше установленное клиентское приложение mongosh для взаимодействия с сервером mongodb. (При работе с mongosh не стоит забывать, что у нас должен быть запущен сервер mongod). Итак, запустим файл mongosh , который располагается в выше рассмотренной папке установки:
При запуске программы mongosh вначале она спросит пользователя, какую строку подключения использовать для подключения к серверу MongoDB. В этом моменте просто нажмем на Enter, чтобы использовать строку подключения к MongoDB по умолчанию. А по умолчанию сервер mongodb запускается на порту 27017, а полная строка подключения выглядит следующим образом: mongodb://localhost:27017 или mongodb://127.0.0.1:27017
После подключения консоль отобразит ряд служебной информации и подключится к базе данных test.
Теперь поизведем какие-либо простейшие действия. Введем в консоль последовательно следующие команды и после каждой команды нажмем на Enter:
db.users.insertOne( < name: "Tom" >) db.users.find()
С помощью функции db.users.insertOne() в коллекцию users базы данных test добавляется объект < name: "Tom" >. Идентификатор db представляет текущую базу данных. В нашем случае мы подключены к базе данных по умолчанию — то есть к базе данных test, соответственно db здесь представляет базу данных test. При этом не важно, есть или нет такая бд — если ее нет, то она создается
После db идет users — это коллекция, в которую затем мы добавляем новый объект. Если в SQL нам надо создавать таблицы заранее, то коллекции MongoDB создает самостоятельно при их отсутствии.
Описание добавляемого объекта определяется в формате, с которым вы возможно знакомы, если имели дело с форматом JSON. То есть в данном случае у объекта определен один ключ «name», которому сопоставляется значение «Tom». То есть мы добавляем пользователя с именем Tom.
Если объект был успешно добавлен, то консоль выведет результат операции, в частности, идентификатор добавленного объекта.
А вторая команда db.users.find() выводит на экран все объекты из бд test.
Из вывода вы можете увидеть, что к начальным значениям объекта было добавлено какое-то непонятно поле ObjectId . Как вы помните, MongoDB в качестве уникальных идентификаторов документа использует поле _id . И в данном случае ObjectId как раз и представляет значение для идентификатора _id.
Установка драйверов MongoDB
В дальнейшем в рамках данного руководства мы будет рассматривать взаимодействие с сервером MongoDB преимущественно через выше использованную оболочку mongo . Однако, мы также можем взаимодействовать с mongodb в наших приложениях, написанных на PHP, C++, C# и других языках программирования. И для этой цели необходим специальный драйвер.
На офсайте на странице https://docs.mongodb.com/ecosystem/drivers/ можно найти список драйверов для всех поддерживаемых языков программирования, в частности, для PHP, C, C++, C#, Java, Go, Python, Rust, Ruby, Scala, Swift, а также для Node.js.
Работа с драйверами на конкретных языках программирования будет рассмотрена в соответствующих разделах, посвященных этим языкам..
Установка MongoDB на разные ОС: Windows, Ubuntu, CentOS
MongoDB — это документо-ориентированная база данных NoSQL, которая используется для хранения больших объемов данных. Вместо таблиц и строк, как в традиционных реляционных базах данных, в данные в MongoDB хранятся в виде документов, подобных JSON-формату.
У MongoDB открытый исходный код, и она имеет бесплатную версию. В этом материале вы узнаете, как установить MongoDB на разные операционные системы: Windows, Ubuntu и CentOS.
На данный момент сайт MongoDB ограничен для пользователей из Российской Федерации и Беларуси. Для получения пакета установщика используйте VPN.
Установка MongoDB на Windows 10
В MongoDB установка на Windows начинается с загрузки дистрибутива. Переходим на официальный сайт систему управления базами данных mongodb.com и нажимаем кнопку «Products». В окне выбираем версию Community. Community — это бесплатная версия MongoDB, поэтому установим её. Выбираем версию СУБД, в нашем случае 5.0.9 и загружаем его в удобном формате — мы выбрали .msi.
После загрузки пакета установщика переходим к непосредственно к установке. Во время установки инсталлятор предложит вам сделать MongoDB службой Windows:
Служба Windows — это приложение, исполняемое при запуске операционной системой Windows и выполняющееся вне зависимости от статуса пользователя. В чем-то служба Windows схожа с демонами из Linux. Если вы по какой-то причине не хотите, чтобы MongoDB была установлена на ваше устройство как служба Windows, то снимите галочку на этом этапе.
Для установки MongoDB Compass не снимайте галочку на этом этапе:
MongoDB Compass — это графический клиент для просмотра и администрирования базы данных.
После нажатия кнопки «Next» начнется установка MongoDB. Во время процесса установщик может не обнаружить некоторых пакетов и предложит их установить. Для их полноценной установки устройство придется перезагрузить. После завершения установки откроется MongoDB Compass.
Установка MongoDB на Ubuntu
Устанавливать MongoDB будем на Ubuntu 22.04. На момент написания статьи репозиторий для Ubuntu 22.04 ещё не вышел, поэтому будет использовать репозиторий для 20.04. Для установки MongoDB на Debian 10/11 руководствуйтесь туториалом на сайте MongoDB.
Заказать облачный сервер с предустановленной ОС Ubuntu или Debian можно в Timeweb Cloud.
Настройка прокси
Репозитории MongoDB недоступны для пользователей из России, и для установки софта понадобится прокси-сервер, расположенный за рубежом. Прокси-сервер — это промежуточный узел между клиентом и целевым сервером. Для того, чтобы apt использовал прокси, его нужно прописать в настройках. Будем использовать простой SOCKS5-прокси.
Откроем конфигурационный файл прокси apt /etc/apt/apt.conf.d/proxy.conf :
sudo nano /etc/apt/apt.conf.d/proxy.conf
И добавим в него информацию о прокси:
Acquire::http::Proxy "socks5h://IpAddres:port";
Acquire::https::Proxy "socks5h://IpAddres:port";
Acquire::socks::Proxy "socks5h://IpAddres:port";
Вместо IpAddres и Port необходимо указать IP-адрес вашего прокси и порт.
Шаг 1. Установка libssl1
Так как используем репозиторий не для нашей системы, то для корректной работы MongoDB необходимо установить пакет libssl1. В ином случае получим такую ошибку:
The following packages have unmet dependencies:
mongodb-org-mongos : Depends: libssl1.1 (>= 1.1.1) but it is not installable
mongodb-org-server : Depends: libssl1.1 (>= 1.1.1) but it is not installable
mongodb-org-shell : Depends: libssl1.1 (>= 1.1.1) but it is not installable
Для установки пакета выполняем следующие команды в терминале:
echo "deb http://security.ubuntu.com/ubuntu focal-security main" | sudo tee /etc/apt/sources.list.d/focal-security.list
sudo apt update
sudo apt install libssl1.1
Добавляем GPG-ключ репозитория MongoDB:
curl -fsSL https://www.mongodb.org/static/pgp/server-5.0.asc | sudo apt-key add -
Добавляем репозиторий MongoDB:
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
sudo apt update
sudo apt install -y mongodb-org
Вот полный список команд для установки MongoDB на Ubuntu 22.04:
echo "deb http://security.ubuntu.com/ubuntu focal-security main" | sudo tee /etc/apt/sources.list.d/focal-security.list
sudo apt update
sudo apt install libssl1.1
curl -fsSL https://www.mongodb.org/static/pgp/server-5.0.asc | sudo apt-key add -
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
sudo apt update
sudo apt install -y mongodb-org
Установка MongoDB Compass
У MongoDB Compass есть три версии:
- Полная — все функции включены;
- Изолированная — все подключения, кроме как к инстансу MongoDB, отключены;
- Только для чтения — без возможности записи и удаления данных.
Установка полной версии:
Установка изолированной версии:
MongoDB: установка на CentOS
Настройка прокси
Для установки MongoDB на CentOS нужно настроить прокси, как и в случае с Ubuntu. Откройте файл /etc/yum.conf и добавьте в него следующие строки:
proxy=http://IpAddres:port
proxy_username=login
proxy_password=password
IpAddres и Port — IP-адрес и порт вашего прокси. Login и Password — имя пользователя и пароль, если для прокси необходима авторизация.
Теперь создадим репозиторий /etc/yum.repos.d/mongodb-org-5.0.repo для установки MongoDB с помощью yum :
sudo yum install -ymongodb-org
Заключение
В этом материале мы разобрали, как установить MongoDB на 3 разные операционные системы. MongoDB — это гибкая и мощная система управления базами данных, которая подойдет для проектов без сложной структуры. К слову, в скором времени MongoDB появится на Timeweb Cloud как облачная база данных (Database-as-a-service).
В официальном канале Timeweb Cloud собрали комьюнити из специалистов, которые говорят про IT-тренды, делятся полезными инструкциями и даже приглашают к себе работать.
Install MongoDB Community Edition on Windows
MongoDB Atlas is a hosted MongoDB service option in the cloud which requires no installation overhead and offers a free tier to get started.
Overview
Use this tutorial to install MongoDB 7.0 Community Edition on Windows using the default installation wizard.
MongoDB Version
This tutorial installs MongoDB 7.0 Community Edition. To install a different version of MongoDB Community , use the version drop-down menu in the upper-left corner of this page to select the documentation for that version.
Installation Method
This tutorial installs MongoDB on Windows using the default MSI installation wizard. To install MongoDB using the msiexec.exe command-line tool instead, see Install MongoDB using msiexec.exe. The msiexec.exe tool is useful for system administrators who wish to deploy MongoDB in an unattended fashion using automation.
Considerations
MongoDB Shell, mongosh
The MongoDB Shell ( mongosh ) is not installed with MongoDB Server. You need to follow the mongosh installation instructions to download and install mongosh separately.
Platform Support
MongoDB 7.0 Community Edition supports the following 64-bit versions of Windows on x86_64 architecture:
- Windows Server 2022
- Windows Server 2019
- Windows 11
MongoDB only supports the 64-bit versions of these platforms.
For more information, see Platform Support .
Note
MongoDB is not supported on Windows Subsystem for Linux (WSL). To run MongoDB on Linux, use a supported Linux system.
Virtualization
for VirtualBox on Windows hosts where Hyper-V is running. However, Microsoft does not support VirtualBox on Hyper-V .
Disable Hyper-V if you want to install MongoDB on Windows using VirtualBox.
Production Notes
Before deploying MongoDB in a production environment, consider the Production Notes document which offers performance considerations and configuration recommendations for production MongoDB deployments.
Full Time Diagnostic Data Capture
MongoDB logs diagnostic data to assist with troubleshooting. For detailed information, see Full Time Diagnostic Data Capture .
On Windows, to collect system data such as disk, cpu, and memory, FTDC requires Microsoft access permissions from the following groups:
- Performance Monitor Users
- Performance Log Users
If the user running mongod and mongos is not an administrator, add them to these groups to log FTDC data. For more information, see the Microsoft documentation here
Install MongoDB Community Edition
Procedure
Follow these steps to install MongoDB Community Edition using the MongoDB Installer wizard. The installation process installs both the MongoDB binaries as well as the default configuration file \bin\mongod.cfg .
Download the installer.
Download the MongoDB Community .msi installer from the following link:
- In the Version dropdown, select the version of MongoDB to download.
- In the Platform dropdown, select Windows .
- In the Package dropdown, select msi .
- Click Download .
Run the MongoDB installer.
For example, from the Windows Explorer/File Explorer:
- Go to the directory where you downloaded the MongoDB installer ( .msi file). By default, this is your Downloads directory.
- Double-click the .msi file.
Follow the MongoDB Community Edition installation wizard.
The wizard steps you through the installation of MongoDB and MongoDB Compass.
- Choose Setup Type You can choose either the Complete (recommended for most users) or Custom setup type. The Complete setup option installs MongoDB and the MongoDB tools to the default location. The Custom setup option allows you to specify which executables are installed and where.
- Service Configuration Starting in MongoDB 4.0, you can set up MongoDB as a Windows service during the install or just install the binaries.
Install mongosh
The .msi installer does not include mongosh . Follow the mongosh installation instructions to download and install the shell separately.
If You Installed MongoDB as a Windows Service
The MongoDB service starts upon successful installation.
If you would like to customize the service, you must stop the service . Customize the MongoDB instance by editing the configuration file at \bin\mongod.cfg .
For information about the available configuration options, refer to Configuration File Options .
If You Did Not Install MongoDB as a Windows Service
If you only installed the executables and did not install MongoDB as a Windows service, you must manually start the MongoDB instance.
Run MongoDB Community Edition as a Windows Service
Starting in version 4.0, you can install and configure MongoDB as a Windows Service during installation. The MongoDB service starts upon successful installation. Configure the MongoDB instance with the configuration file \bin\mongod.cfg .
If you have not already done so, follow the mongosh installation instructions to download and install the MongoDB Shell ( mongosh ).
Be sure to add the path to your mongosh.exe binary to your PATH environment variable during installation.
Open a new Command Interpreter and enter mongosh.exe to connect to MongoDB.
For more information on connecting to a mongod using mongosh.exe , such as connecting to a MongoDB instance running on a different host and/or port, see Connect to a Deployment .
For information on CRUD (Create, Read, Update, Delete) operations, see:
- Insert Documents
- Query Documents
- Update Documents
- Delete Documents
Start MongoDB Community Edition as a Windows Service
To start/restart the MongoDB service, use the Services console:
- From the Services console, locate the MongoDB service.
- Right-click on the MongoDB service and click Start .
Stop MongoDB Community Edition as a Windows Service
To stop/pause the MongoDB service, use the Services console:
- From the Services console, locate the MongoDB service.
- Right-click on the MongoDB service and click Stop (or Pause ).
Remove MongoDB Community Edition as a Windows Service
To remove the MongoDB service, first use the Services console to stop the service. Then open a Windows command prompt/interpreter
( cmd.exe ) as an Administrator , and run the following command:
sc.exe delete MongoDB
Run MongoDB Community Edition from the Command Interpreter
You can run MongoDB Community Edition from the Windows command prompt/interpreter ( cmd.exe ) instead of as a service.
( cmd.exe ) as an Administrator .
Important
You must open the command interpreter as an Administrator .
Create database directory.
Create the data directory where MongoDB stores data. MongoDB’s default data directory path is the absolute path \data\db on the drive from which you start MongoDB.
From the Command Interpreter , create the data directories:
cd C:\ md "\data\db"
Start your MongoDB database.
To start MongoDB, run mongod.exe .
"C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe" --dbpath="c:\data\db"
The —dbpath option points to your database directory.
If the MongoDB database server is running correctly, the Command Interpreter displays:
[initandlisten] waiting for connections
Important
settings on your Windows host, Windows may display a Security Alert dialog box about blocking «some features» of C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe from communicating on networks. To remedy this issue:
- Click Private Networks, such as my home or work network .
- Click Allow access .
To learn more about security and MongoDB, see the Security Documentation .
Connect to MongoDB.
If you have not already done so, follow the mongosh installation instructions to download and install the MongoDB Shell ( mongosh ).
Be sure to add the path to your mongosh.exe binary to your PATH environment variable during installation.
Open a new Command Interpreter and enter mongosh.exe to connect to MongoDB.
For more information on connecting to mongod using mongosh.exe , such as connecting to a MongoDB instance running on a different host and/or port, see Connect to a Deployment .
For information on CRUD (Create, Read, Update, Delete) operations, see:
- Insert Documents
- Query Documents
- Update Documents
- Delete Documents
Additional Considerations
Localhost Binding by Default
By default, MongoDB launches with bindIp set to 127.0.0.1 , which binds to the localhost network interface. This means that the mongod.exe can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod.exe , and the mongod.exe will not be able to initialize a replica set unless this value is set to a valid network interface.
This value can be configured either:
- in the MongoDB configuration file with bindIp , or
- via the command-line argument —bind_ip
Warning
Before you bind your instance to a publicly-accessible IP address, you must secure your cluster from unauthorized access. For a complete list of security recommendations, see Security Checklist. At minimum, consider enabling authentication and hardening network infrastructure .
For more information on configuring bindIp , see IP Binding .
Point Releases and .msi
If you installed MongoDB with the Windows installer ( .msi ), the .msi automatically upgrades within its release series (e.g. 4.2.1 to 4.2.2).
Upgrading a full release series (e.g. 4.0 to 4.2) requires a new installation.
Add MongoDB binaries to the System PATH
If you add C:\Program Files\MongoDB\Server\7.0\bin to your System PATH you can omit the full path to the MongoDB Server binaries. You should also add the path to mongosh if you have not already done so.
- Overview
- Considerations
- Install MongoDB Community Edition
- Run MongoDB Community Edition as a Windows Service
- Run MongoDB Community Edition from the Command Interpreter
- Additional Considerations