MySQL 설치 macOS (2026년 최신) - Homebrew로 5분만에 설치하기

macOS에서 MySQL 설치하는 가장 쉬운 방법은 Homebrew다. 터미널 명령어 몇 줄이면 끝난다.

버전 선택

버전 Homebrew 패키지 특징

8.4 LTS	mysql@8.4	안정적, 장기지원
최신 (9.x)	mysql	최신 기능

실무나 학습용이면 8.4 LTS를 추천한다.

1. Homebrew 설치 확인

터미널 열고 Homebrew가 설치되어 있는지 확인

brew --version

설치되어 있으면 버전이 표시된다.

Homebrew 4.x.x

Homebrew 미설치 시

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 후 터미널 재시작

2. MySQL 설치

8.4 LTS 설치 (권장)

brew install mysql@8.4

최신 버전 설치

brew install mysql

설치에 2-3분 정도 소요된다.

3. 환경변수 설정

mysql@8.4로 설치하면 PATH에 자동 추가되지 않는다. 쉘 설정 파일에 추가해야 한다.

zsh 사용자 (기본)

echo 'export PATH="/opt/homebrew/opt/mysql@8.4/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

bash 사용자

echo 'export PATH="/opt/homebrew/opt/mysql@8.4/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

Intel Mac인 경우

경로가 다르다.

echo 'export PATH="/usr/local/opt/mysql@8.4/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

확인

mysql --version

mysql  Ver 8.4.x for macos14.x on arm64 (Homebrew)

4. MySQL 서비스 시작

Homebrew Services로 시작 (권장)

brew services start mysql@8.4

부팅 시 자동 시작된다.

수동으로 시작 (1회성)

/opt/homebrew/opt/mysql@8.4/bin/mysqld_safe --datadir=/opt/homebrew/var/mysql

서비스 상태 확인

brew services list

Name       Status  User   File
mysql@8.4  started myuser ~/Library/LaunchAgents/homebrew.mxcl.mysql@8.4.plist

5. 초기 보안 설정

MySQL 설치 직후에는 root 비밀번호가 없다. 보안 설정 스크립트를 실행한다.

mysql_secure_installation

설정 과정

Securing the MySQL server deployment.

Connecting to MySQL using a blank password.

VALIDATE PASSWORD COMPONENT을 설치할까요?
Press y|Y for Yes, any other key for No: n
(비밀번호 정책 - 학습용은 No, 실무는 Yes)

New password: ********
Re-enter new password: ********
(root 비밀번호 설정)

Remove anonymous users?
Press y|Y for Yes, any other key for No: y
(익명 사용자 삭제 - Yes 권장)

Disallow root login remotely?
Press y|Y for Yes, any other key for No: y
(원격 root 로그인 차단 - Yes 권장)

Remove test database and access to it?
Press y|Y for Yes, any other key for No: y
(테스트 DB 삭제 - Yes 권장)

Reload privilege tables now?
Press y|Y for Yes, any other key for No: y
(권한 테이블 새로고침 - Yes)

모두 완료되면 보안 설정 끝

6. MySQL 접속 확인

mysql -u root -p
Enter password: ********

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 8.4.x Homebrew

mysql>

버전 확인

SELECT VERSION();

데이터베이스 목록

SHOW DATABASES;

종료

EXIT;

7. 자주 쓰는 명령어

서비스 관리

# 시작
brew services start mysql@8.4

# 중지
brew services stop mysql@8.4

# 재시작
brew services restart mysql@8.4

# 상태 확인
brew services list

MySQL 접속

# root로 접속
mysql -u root -p

# 특정 DB로 바로 접속
mysql -u root -p mydb

데이터 디렉토리 위치

# Apple Silicon Mac
/opt/homebrew/var/mysql

# Intel Mac
/usr/local/var/mysql

설정 파일 위치

# Apple Silicon Mac
/opt/homebrew/etc/my.cnf

# Intel Mac
/usr/local/etc/my.cnf

8. MySQL Workbench 설치 (선택)

GUI 툴이 필요하면 Workbench를 설치한다.

Homebrew Cask로 설치

brew install --cask mysqlworkbench

또는 공식 사이트에서 다운로드

https://dev.mysql.com/downloads/workbench/

macOS용 DMG 파일 다운로드 후 설치

9. 자주 발생하는 문제

mysql 명령어를 찾을 수 없음

zsh: command not found: mysql

해결: 환경변수 설정 후 터미널 재시작

source ~/.zshrc

소켓 에러

ERROR 2002 (HY000): Can't connect to local MySQL server through socket

해결: MySQL 서비스가 실행 중인지 확인

brew services list
brew services restart mysql@8.4

비밀번호 분실

1. 서비스 중지

brew services stop mysql@8.4

1. 안전 모드로 시작

mysqld_safe --skip-grant-tables &

1. 비밀번호 재설정

mysql -u root

mysql> FLUSH PRIVILEGES;
mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY '새비밀번호';
mysql> EXIT;

1. 서비스 재시작

brew services restart mysql@8.4

포트 충돌

ERROR 2002 (HY000): Can't connect to local MySQL server

다른 MySQL이나 MariaDB가 실행 중일 수 있다.

# 3306 포트 사용 프로세스 확인
lsof -i :3306

# 프로세스 종료
kill -9 [PID]

10. 완전 삭제 (재설치 시)

MySQL을 완전히 삭제하고 재설치하려면

# 서비스 중지
brew services stop mysql@8.4

# 패키지 삭제
brew uninstall mysql@8.4

# 데이터 디렉토리 삭제
rm -rf /opt/homebrew/var/mysql

# 설정 파일 삭제
rm -rf /opt/homebrew/etc/my.cnf
rm -rf /opt/homebrew/etc/my.cnf.d

정리

단계 명령어

설치	brew install mysql@8.4
PATH 추가	echo 'export PATH=...' >> ~/.zshrc
서비스 시작	brew services start mysql@8.4
보안 설정	mysql_secure_installation
접속	mysql -u root -p

Homebrew 덕분에 macOS에서는 5분이면 MySQL 설치가 끝난다.

다음 글에서는 Linux(Ubuntu)에서 MySQL 설치하는 방법을 정리한다.