macOS에서 Homebrew로 MongoDB Community Server 8.2 설치하기

환경: Apple Silicon Mac (M4) / macOS / Homebrew
MongoDB Community Server 8.2.11

1. MongoDB Homebrew Tap 추가

MongoDB는 공식 Homebrew 저장소가 아닌 별도의 MongoDB 공식 Tap을 사용합니다.

brew tap mongodb/brew

설치할 MongoDB Formula가 있는 저장소를 Homebrew에 등록하는 과정입니다.

---

2. MongoDB Community Server 8.2 설치

brew install mongodb-community@8.2

설치 과정에서 MongoDB와 함께 필요한 의존성 패키지들도 Homebrew를 통해 설치됩니다.

이번 설치 결과:

mongodb-community@8.2/8.2.11

그리고 MongoDB Shell인 mongosh도 함께 설치되었습니다.

설치가 완료되면 다음과 같은 안내가 표시됩니다.

To start mongodb/brew/mongodb-community@8.2 now and restart at login:
  brew services start mongodb/brew/mongodb-community@8.2

---

3. MongoDB 서비스로 실행

MongoDB를 macOS의 백그라운드 서비스로 실행합니다.

brew services start mongodb/brew/mongodb-community@8.2

정상적으로 실행되면:

Successfully started `mongodb-community@8.2`

와 같은 메시지가 표시됩니다.

실행 상태 확인

brew services list

정상적인 경우:

Name                     Status   User        File
mongodb-community@8.2    started  사용자명    ~/Library/LaunchAgents/homebrew.mxcl.mongodb-community@8.2.plist

여기서 started가 표시되면 MongoDB 서비스가 실행 중인 상태입니다.

또한 brew services start 방식으로 등록했기 때문에 Mac에 로그인할 때 MongoDB가 자동으로 실행됩니다.

---

4. MongoDB Shell 접속

MongoDB가 실행된 상태에서:

mongosh

를 입력합니다.

정상적으로 연결되면 다음과 비슷하게 표시됩니다.

Current Mongosh Log ID: ...
Connecting to: mongodb://127.0.0.1:27017/
Using MongoDB: 8.2.11
Using Mongosh: 2.9.2
test>

여기서 기본적으로 27017 포트를 사용하고 있음을 확인할 수 있습니다.

---

5. MongoDB 서버 정상 동작 확인

mongosh에서 다음 명령을 실행합니다.

db.runCommand({ ping: 1 })

정상적인 경우:

{ ok: 1 }

이 출력되면 MongoDB 서버에 정상적으로 연결되었고 서버가 정상적으로 응답하고 있다는 의미입니다.

---

6. MongoDB Shell 종료

MongoDB 자체를 종료하는 것이 아니라 mongosh 프로그램만 종료하려면:

exit

또는:

Ctrl + D

를 사용할 수 있습니다.

종료하면 다시 macOS 터미널 프롬프트로 돌아옵니다.

exit는 MongoDB 서버를 종료하는 명령이 아닙니다. MongoDB Shell 접속만 종료합니다.

---

7. MongoDB 서버 자체를 중지하려면

MongoDB 서버를 완전히 중지하고 싶을 때는:

brew services stop mongodb-community@8.2

다시 실행하려면:

brew services start mongodb-community@8.2

---

전체 과정만 한눈에 보기

# 1. MongoDB 공식 Homebrew Tap 추가
brew tap mongodb/brew

# 2. MongoDB Community Server 8.2 설치
brew install mongodb-community@8.2

# 3. MongoDB 서비스 시작
brew services start mongodb/brew/mongodb-community@8.2

# 4. 서비스 상태 확인
brew services list

# 5. MongoDB Shell 접속
mongosh

mongosh에 접속한 후:

// MongoDB 서버 연결 테스트
db.runCommand({ ping: 1 })

// Shell 종료
exit