macOSにMongoDBをインストールする方法|Homebrewを使った初心者向けステップバイステップガイド

本ガイドでは、macOS環境へのMongoDBのインストール方法を詳しく解説します。macOSにMongoDBをインストールする方法は主に2つあります。1つは公式サイトからTAR.GZファイルをダウンロードして手動で展開する方法、もう1つはパッケージマネージャーのHomebrewを利用する方法です。TAR.GZファイルは、WindowsでいうZIPファイルのように複数のファイルを1つのアーカイブにまとめたものですが、手動での設定が複雑なため、多くの開発者にとってハードルが高いのが実情です。そこで本記事では、より簡単で確実なHomebrewを使ったインストール方法をご紹介します。

Homebrewとは?

Homebrewは、macOSに標準搭載されていない「不足しているパッケージマネージャー」と呼ばれる無料ユーティリティです。コマンドラインからライブラリやソフトウェアパッケージを簡単にインストール・アップデート・管理できるようになります。

なぜHomebrewが必要なのか?

厳密には、TAR.GZファイルを使えばHomebrewなしでもMongoDBをインストールすることは可能です。ただし、手作業が多く難易度は高めです。Homebrew経由でMongoDBをインストールすれば、以下のようなメリットが得られます。

• コンパイル、ダウンロード、設定のプロセスが自動化され、大幅な時間の節約になる
• ユーティリティ、ライブラリ、プログラミング言語など、あらゆるソフトウェアを1つのコマンドでインストールできる

さらに詳しく知りたい方は、公式サイトbrew.shをご覧ください。

それでは、Homebrewを使ってMongoDBをインストールする具体的な手順を見ていきましょう。

事前準備:Homebrewのインストール

1. MongoDBをインストールする前に、まずHomebrew本体をインストールします。
2. ターミナルを開き、ブラウザでbrew.shにアクセスします。
3. ページに表示されているコマンドを、コピーアイコンをクリックしてコピーします。
4. コピーしたコマンドをターミナルに貼り付けてEnterキーを押します。この時点ではまだHomebrew自体は有効化されていません。続いて、隠しファイルである.zshrc(シェル設定ファイル)にHomebrewのパスを登録する必要があります。
5. ホームディレクトリに移動するため、cdと入力してEnterキーを押します。
6. ls -laと入力してEnterキーを押すと、隠しファイルを含むすべてのファイルが一覧表示されます。
7. ドットで始まるファイルがいくつか表示されるので、その中の.zshrcファイルを探します。
8. vim ~/.zshrcと入力してEnterキーを押し、Vimエディタで.zshrcファイルを開きます。
9. iキーを押して挿入モードに切り替え、以下のコマンドを入力してHomebrewのパスを追加します。

   export PATH="$PATH:/opt/homebrew/bin/"

10. 入力が完了したらEscキーを押し、「:(コロン)」→「wq」(保存して終了)と入力してEnterキーを押します。
11. 次に、.zshrcを再読み込みしてHomebrewを有効化します。以下のコマンドを実行するか、ターミナルを再起動してください。

    source ~/.zshrc

12. Homebrewが正しくインストールされたか確認するため、以下のコマンドを入力します。

    brew --version

13. バージョン情報が表示されれば、Homebrewのインストールは成功です。次はいよいよMongoDBのインストールに進みましょう。

MongoDBのインストール手順

1. まず、Xcodeコマンドラインツールをインストールします。以下のコマンドを実行してください。

   xcode-select --install

2. Xcodeツールのインストールが完了したら、以下のコマンドでMongoDBの公式リポジトリ(tap)を追加します。これにより、HomebrewがMongoDBを認識できるようになります。

   brew tap mongodb/brew

3. 最後に、以下のコマンドでMongoDB Community Editionをインストールします。

   brew install mongodb-community@6.0

MongoDBサービスの起動と停止

MongoDBのインストールが完了しても、すぐに使い始めることはできません。まずサービスを起動する必要があります。以下のコマンドでMongoDBサービスを起動できます。

brew services start mongodb-community@6.0

サービスを停止したい場合は、同じコマンドのstartをstopに置き換えて実行するだけです。

brew services stop mongodb-community@6.0

毎回これらのコマンドを入力するのは面倒ですよね。ターミナルを閉じてもMongoDBサーバーをバックグラウンドプロセスとして動かし続けたい場合は、以下のコマンドを使用します。

mongod --config /opt/homebrew/etc/mongod.conf --fork

MongoDB Shell(mongosh)の起動と動作確認

いつでも以下のコマンドでMongoDBシェルを起動できます。

mongosh

シェルが起動したら、プロジェクトの作業を始められます。MongoDBサーバーが正常に稼働しているか確認するには、show dbsと入力してみてください。MongoDBのデフォルトデータベースの一覧が表示されれば、サーバーは正常に動作しています。

以上で、macOSへのMongoDBのインストールは完了です!

うまくいかないときは

インストール中に問題が発生した場合は、Stack OverflowなどのプログラミングフォーラムやFacebookグループで質問を投稿してみると、解決策が見つかることがあります。エラーメッセージをそのまま添えて質問すると、より的確な回答を得やすくなります。

著者について

Hamza Mohammad Anwar(ハムザ・モハンマド・アンワル)

Hamza Mohammad Anwarは、MERNスタック技術を活用した高パフォーマンスアプリケーション開発を専門とするJavaScriptウェブ開発者です。ReactJS、MongoDB、Express、Node.jsなど関連技術に精通しており、Google IT認定資格も保有しています。熱心な問題解決者として、自身のPC上でエラーを意図的に再現し、さまざまな技術的問題のトラブルシューティングと解決策の探究に日々取り組んでいます。