맥북에 MariaDB를 설치하려고 검색하면 brew install mariadb 한 줄로 끝나는 간단한 설명 글이 많은데요.
이 명령은 프로그램만 내려받을 뿐 서버를 켜지 않기 때문에 서버가 꺼진 상태에서 mariadb를 입력하면 연결할 대상이 없어서 접속이 되지 않습니다.
맥북에서 MariaDB 설치는 brew install mariadb, 실행은 brew services start mariadb, 접속은 mariadb 명령으로 사용할 수 있습니다.
또한 이미 맥북에서 MySQL을 쓰고 있거나 MariaDB와 함께 쓸 계획이라면 Homebrew는 mysql과 mariadb 패키지가 같은 이름의 실행 파일을 설치한다는 이유로 두 패키지를 충돌 관계로 지정해 설치가 실행되지 않습니다. 버전이 붙은 MySQL 패키지를 골라도 기본 포트와 데이터 디렉터리가 MariaDB와 같기 때문에 두 서버를 동시에 켤 수 없는 것이 이유인데요.
MySQL은 버전이 이름에 붙은 패키지(예 : mysql@8.4)를 3307 포트와 별도 데이터 디렉터리로 실행하면 MariaDB와 동시에 쓸 수 있습니다.
1. Homebrew로 맥북 MariaDB 설치하기
MariaDB 서버는 Homebrew의 mariadb 패키지로 설치하며, brew install mariadb 명령어로 서버(mariadbd)와 클라이언트(mariadb)가 함께 설치됩니다.
MariaDB를 설치 하려면, Command + Space로 Spotlight를 열고 Terminal을 입력해 터미널 앱을 실행합니다. 설치 도구인 Homebrew가 있는지 먼저 확인합니다.
brew --versionHomebrew 버전이 출력되면 다음 단계로 넘어갑니다. zsh: command not found: brew가 출력되면 Homebrew가 없는 상태이므로 홈브류 설치 방법대로 먼저 설치합니다.
MariaDB를 내려받아 설치합니다. 하드웨어와 네트워크 속도에 따라 몇 분이 걸립니다.
brew install mariadb2026년 10월 17일 기준으로 brew info mariadb가 보여 주는 stable 버전은 13.0.2입니다. mariadb@10.11처럼 버전이 붙은 패키지를 설치했다면 이후 brew services 명령에서도 동일한 이름으로 서비스를 호출해야 합니다. 예) brew services start mariadb@10.11
mariadb --version설치가 끝나면 설치된 버전을 확인합니다. 출력의 Distrib 뒤에 붙은 숫자가 MariaDB 서버 버전입니다.
설치 직후 Homebrew가 출력하는 안내문에는 서버를 켜는 명령이 들어 있지만, 설치만으로는 서버가 켜지지 않아 별도 명령으로 서버를 켜야 합니다.
2. brew services로 맥북 MariaDB 실행하기
맥북에서 MariaDB 실행은 brew services start mariadb 명령어이며, 이 명령은 서버를 백그라운드 서비스로 등록하므로 맥을 다시 시작하고 로그인해도 서버가 자동으로 실행됩니다.
서버를 켜서 MariaDB를 접속할 수 있는 상태로 만듭니다.
brew services start mariadb서비스가 켜졌는지는 목록에서 확인합니다. mariadb 줄의 Status가 started이면 실행 중입니다.
brew services list서버가 실제로 포트를 열었는지도 확인할 수 있습니다. 아래 명령에 mariadbd가 3306 포트를 사용하는 줄이 나오면 정상입니다.
lsof -nP -iTCP:3306 -sTCP:LISTEN서비스를 처음 등록하면 macOS가 백그라운드에서 실행할 항목을 추가했다고 알립니다. 알림에서 추가를 허용하면 서버가 시스템 설정 > 일반 > 로그인 항목 및 확장 프로그램(Login Items & Extensions)에 mariadbd-safe 이름으로 등록되며, 여기서 스위치를 끄면 자동 실행만 중지됩니다.
서비스 등록 없이 지금 한 번만 서버를 켜려면 아래 명령을 사용합니다. 이 방법은 맥을 다시 시작하면 서버가 꺼집니다.
mysql.server start서버를 끄려면 brew services stop mariadb를 실행합니다.
3. mariadb 명령으로 맥북 MariaDB 접속 확인하기
서버가 켜진 뒤 터미널에 mariadb를 입력하면 현재 로그인한 macOS 사용자 이름의 계정으로 접속되고, MariaDB [(none)]> 프롬프트가 나오면 SQL을 입력할 수 있는 상태입니다.
mariadb서버가 꺼져 있으면 ERROR 2002 (HY000): Can't connect to local server through socket 오류가 출력되므로, brew services list에서 mariadb의 Status가 started인지 확인하고 아니면 brew services start mariadb로 서버를 켭니다.
접속한 계정과 서버 버전은 아래 SQL로 확인합니다. SQL 문장은 끝에 세미콜론(;)을 붙여야 실행됩니다. 계정은 맥_사용자_이름@localhost 형태로 표시됩니다.
SELECT USER(), VERSION();MySQL을 함께 설치하려면 MariaDB가 쓰는 포트, 소켓, 데이터 디렉터리가 어디인지 알아야 합니다. 아래 SQL로 세 값을 조회합니다.
SHOW VARIABLES WHERE Variable_name IN ('port', 'socket', 'datadir');Apple 실리콘 맥의 Homebrew 기본 설치에서는 다음 값이 나옵니다.
| Variable_name | Value |
|---|---|
| port | 3306 |
| socket | /tmp/mysql.sock |
| datadir | /opt/homebrew/var/mysql/ |
접속을 끝내려면 EXIT;를 입력합니다.
root 계정으로 접속하려면 터미널에서 sudo mysql -u root를 실행합니다. root에 비밀번호를 지정하는 방법은 MariaDB root 비밀번호 설정 글에 정리되어 있습니다.
4. 맥북에 MySQL, MariaDB 동시 설치하기
MySQL과 MariaDB를 한 맥북에서 동시에 쓰려면 mysql 대신 버전이 붙은 mysql@8.4를 설치하고, MySQL 서버를 MariaDB와 다른 포트, 소켓, 데이터 디렉터리로 직접 실행해야 합니다.
brew install mysql로 설치하는 최신 MySQL 패키지는 mariadb와 같은 이름의 실행 파일을 설치해서 Homebrew가 충돌로 지정한 조합으로 mariadb가 설치된 맥북에서 brew install mysql을 실행하면 아래 오류로 설치가 중단됩니다.
Error: Cannot install mysql because conflicting formulae are installed.
mariadb: because both install the same binaries
Please `brew unlink mariadb` before continuing.안내대로 brew unlink mariadb를 실행하면 mariadb 명령이 /opt/homebrew/bin에서 빠지므로, 이 글에서는 mysql@8.4를 예시로 들겠습니다.
mysql@8.4는 MySQL의 장기 지원(LTS) 버전이고, 다른 버전용 패키지라서 /opt/homebrew/bin에 연결되지 않는 keg-only 패키지이므로 실행 파일이 겹치지 않습니다.
실행 파일이 겹치지 않아도 서버 설정은 겹칩니다. Homebrew 패키지는 기본 설정에서 포트 3306, 같은 소켓, 같은 데이터 디렉터리를 모두 쓰려고 하기 때문에 MariaDB가 켜진 상태에서 MySQL을 그대로 켜면 포트부터 충돌합니다. 그래서 MySQL에는 아래 값을 따로 지정합니다.
| 항목 | MariaDB와 MySQL의 기본값 | MySQL에 지정할 값 |
|---|---|---|
| 포트 | 3306 | 3307 |
| 소켓 | /tmp/mysql.sock | /tmp/mysql84.sock |
| 데이터 디렉터리 | /opt/homebrew/var/mysql | /opt/homebrew/var/mysql84 |
인텔 맥은 아래 명령의 /opt/homebrew를 /usr/local로 바꿔 입력합니다.
mysql@8.4 설치하기
MariaDB 서버는 켜 둔 채로 MySQL 패키지만 추가합니다. 이 명령은 실행 중인 MariaDB에 영향을 주지 않습니다.
brew install mysql@8.4MySQL 전용 데이터 디렉터리 만들기
MySQL이 MariaDB 데이터를 건드리지 않도록 새 디렉터리를 초기화합니다. --initialize-insecure는 root 비밀번호가 없는 상태로 초기화하는 옵션입니다.
/opt/homebrew/opt/mysql@8.4/bin/mysqld --initialize-insecure --datadir=/opt/homebrew/var/mysql843307 포트로 MySQL 실행하기
데이터 디렉터리, 포트, 소켓을 MariaDB와 겹치지 않게 지정해 서버를 켭니다. 이 명령은 터미널을 계속 점유하므로 끝에 &를 붙여 백그라운드로 실행합니다.
/opt/homebrew/opt/mysql@8.4/bin/mysqld_safe --datadir=/opt/homebrew/var/mysql84 --port=3307 --socket=/tmp/mysql84.sock &이 방식으로 켠 MySQL은 맥을 다시 시작하면 꺼지므로 같은 명령을 다시 실행합니다.
두 서버가 동시에 포트를 열었는지 확인합니다. mariadbd가 3306, mysqld가 3307을 사용하는 줄이 나오면 두 서버를 동시에 쓸 수 있습니다. mysqld가 X 프로토콜용 33060 포트도 함께 여는 줄이 보이지만 MariaDB와 겹치지 않으므로 그대로 둡니다.
lsof -nP -iTCP -sTCP:LISTEN | grep -E 'mariadbd|mysqld'MySQL에 접속하기
MySQL에는 소켓 대신 포트로 접속합니다. 접속 후 SELECT VERSION();을 실행하면 8.4 버전이 표시됩니다.
/opt/homebrew/opt/mysql@8.4/bin/mysql -u root -h 127.0.0.1 -P 3307초기화 직후 MySQL root에는 비밀번호가 없으므로, 접속한 상태에서 ALTER USER로 지정합니다.
ALTER USER 'root'@'localhost' IDENTIFIED BY '새_비밀번호';MariaDB는 지금까지처럼 mariadb 명령으로 접속합니다. MySQL 서버를 끄려면 아래 명령을 실행합니다. Enter password:가 나오면 ALTER USER로 지정한 비밀번호를 입력하고, 지정하지 않았다면 Enter만 누릅니다.
/opt/homebrew/opt/mysql@8.4/bin/mysqladmin -u root -p -h 127.0.0.1 -P 3307 shutdown마치며
MariaDB는 brew install로 설치만 해서는 접속할 수 없고, brew services로 서버를 켜야 접속할 수 있습니다.
MySQL을 함께 쓸 때 문제가 되는 것은 프로그램 자체가 아니라 포트, 소켓, 데이터 디렉터리의 중복입니다. 서버를 하나 더 올릴 때마다 이 세 값을 먼저 비교하고 겹치는 값을 바꾸면 같은 방식으로 DB 서버를 늘릴 수 있습니다.
접속이 확인됐다면 다음 작업은 root 계정 보안입니다. MariaDB의 root 비밀번호는 MariaDB root 비밀번호 설정 글대로 지정하고, MySQL root는 ALTER USER로 지정한 비밀번호로 접속합니다.
FAQ
brew services start mysql@8.4로 MySQL을 실행하면 안되나요?
실행하면 안 됩니다. mysql@8.4 패키지의 서비스는 데이터 디렉터리를 /opt/homebrew/var/mysql로 고정해 실행하는데, 이 경로는 MariaDB가 이미 사용 중입니다. 3307 포트와 전용 데이터 디렉터리를 지정하는 이 글의 방법으로 직접 실행해야 합니다.
설치한 MariaDB를 최신 버전으로 올리려면 어떻게 하나요?
brew update로 Homebrew 정보를 갱신한 뒤 brew upgrade mariadb를 실행하고, 서버를 brew services restart mariadb로 다시 시작해야 새 버전으로 올라옵니다.
인텔 맥에서는 설치 경로가 어떻게 다르나요?
인텔 맥은 Apple 실리콘의 /opt/homebrew 대신 /usr/local 아래에 설치됩니다. 설정 파일은 /usr/local/etc/my.cnf, 데이터 디렉터리는 /usr/local/var/mysql입니다.
