Mac용 MariaDB 설치 방법 M1/M2 맥북 Homebrew 활용 최신 버전 설치와 데이터베이스 접속 설정 상세 더보기

by

Mac 환경에서 데이터베이스를 구축하는 것은 웹 개발자나 데이터 분석가에게 필수적인 과정입니다. 특히, 오픈 소스 관계형 데이터베이스인 MariaDB는 MySQL과의 높은 호환성과 안정성으로 많은 사용자들에게 선택받고 있습니다. 이 가이드에서는 2025년 현재, M1/M2 칩셋을 포함한 모든 Mac 환경에서 가장 권장되는 방법인 Homebrew를 사용하여 MariaDB를 설치하고 초기 설정까지 완료하는 상세한 방법을 안내합니다.

이 포스팅은 단순한 설치 단계를 넘어, 최신 Mac 운영체제 환경에 맞춰 발생할 수 있는 잠재적인 문제점과 해결책, 그리고 기본적인 데이터베이스 접속 방법까지 다루어, 초보자도 쉽게 따라 할 수 있도록 구성되었습니다. Mac에서 MariaDB를 안정적으로 구동하고 싶다면, 이 가이드를 통해 확실하게 환경을 구축해 보시기 바랍니다. Homebrew를 사용하면 설치 과정이 매우 간편하고, 시스템 환경을 깔끔하게 유지할 수 있다는 장점이 있습니다.

MariaDB는 꾸준히 업데이트되고 있으며, 2024년의 트렌드였던 안정성과 성능 최적화가 2025년에도 이어지고 있습니다. 특히 M1/M2 Mac에서의 네이티브 지원은 성능 면에서 큰 이점을 제공합니다. 최신 버전을 설치하여 이 모든 이점을 누려보세요.

Homebrew를 이용한 Mac MariaDB 설치 준비 작업 확인하기

MariaDB 설치를 시작하기 전에, Mac에 필수적으로 설치되어 있어야 할 도구가 있습니다. 바로 macOS용 패키지 관리자인 Homebrew입니다. Homebrew가 설치되어 있지 않다면, 터미널을 열고 다음 명령어를 실행하여 설치를 완료해야 합니다.

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

설치가 완료되면, Mac의 칩셋 종류(Intel 또는 M1/M2)에 따라 환경 변수를 설정하라는 메시지가 나타날 수 있습니다. 이 지침을 따라 환경 설정을 완료하는 것이 중요합니다. M1/M2 Mac 사용자의 경우, Homebrew가 Apple Silicon에 최적화된 경로로 설치되었는지 확인해야 합니다.

Homebrew 설치 후에는 다음 명령어로 최신 상태를 유지합니다:

  • brew update: Homebrew 자체를 최신 상태로 업데이트
  • brew upgrade: 이미 설치된 패키지들을 최신 버전으로 업그레이드

이 과정을 통해 설치 환경이 최적화되면, MariaDB 설치 시 발생하는 대부분의 의존성 문제를 예방할 수 있습니다.

M1/M2 Mac 포함 MariaDB 최신 버전 설치 상세 더보기

Homebrew가 준비되었다면, MariaDB 설치는 매우 간단합니다. 터미널에 다음 명령어를 입력합니다.

brew install mariadb

Homebrew는 MariaDB의 최신 안정 버전을 자동으로 다운로드하고 설치합니다. 이 과정에서 필요한 모든 종속성(Dependencies)도 함께 처리됩니다. M1/M2 Mac에서도 별도의 아키텍처 설정 없이 네이티브 버전으로 설치가 진행되어 최적의 성능을 기대할 수 있습니다.

설치 확인 및 서비스 관리

설치 완료 후, MariaDB 서비스가 제대로 설치되었는지 확인하고, 서비스를 시작할 수 있습니다.

  • 설치 확인: mysql --version (MariaDB는 MySQL 클라이언트를 사용하므로 이 명령어로 버전을 확인할 수 있습니다.)
  • 서비스 시작: brew services start mariadb
  • 서비스 상태 확인: brew services list (mariadb 항목 옆에 ‘started’라고 표시되어야 합니다.)
  • 서비스 중지: brew services stop mariadb

brew services start mariadb 명령어를 사용하면 Mac이 부팅될 때 자동으로 MariaDB 서비스가 실행되도록 설정됩니다. 개발 환경에서는 이 설정을 유지하는 것이 편리합니다.

MariaDB 초기 보안 설정 및 루트 비밀번호 설정 보기

MariaDB를 설치한 후에는 반드시 초기 보안 설정을 진행해야 합니다. 이 과정은 데이터베이스의 보안을 강화하고 루트(root) 사용자의 비밀번호를 설정하는 중요한 단계입니다.

다음 명령어를 터미널에 입력하여 보안 스크립트를 실행합니다.

mysql_secure_installation

스크립트 실행 시 나타나는 주요 질문에 대한 권장 답변은 다음과 같습니다.

  1. Enter current password for root (or press Enter for none): 처음 설치 시에는 비밀번호가 없으므로 Enter를 누릅니다.
  2. Set root password? [Y/n]: Y를 입력하여 루트 비밀번호를 설정합니다. 강력한 비밀번호를 설정하세요.
  3. Remove anonymous users? [Y/n]: Y를 입력하여 익명 사용자를 제거합니다.
  4. Disallow root login remotely? [Y/n]: Y를 입력하여 원격 루트 로그인을 비활성화합니다. (보안상 권장되지만, 필요에 따라 N을 선택할 수 있습니다.)
  5. Remove test database and access to it? [Y/n]: Y를 입력하여 테스트 데이터베이스를 제거합니다.
  6. Reload privilege tables now? [Y/n]: Y를 입력하여 변경 사항을 즉시 적용합니다.

이 과정을 통해 MariaDB 환경의 보안이 크게 향상됩니다. 루트 비밀번호는 반드시 기억하거나 안전한 곳에 보관해야 합니다.

데이터베이스 접속 및 사용자 생성 방법 확인하기

이제 MariaDB 서비스가 실행 중이고 보안 설정까지 완료되었으므로, 데이터베이스에 접속하고 새로운 사용자를 생성하는 방법을 알아봅니다. 루트 사용자로 접속하여 기본적인 작업을 수행할 수 있습니다.

데이터베이스 접속

터미널에서 설정한 루트 비밀번호를 사용하여 MariaDB 클라이언트에 접속합니다.

mysql -u root -p

위 명령어를 실행하면 비밀번호를 입력하라는 메시지가 나타납니다. 설정한 루트 비밀번호를 입력하면 MariaDB 명령 프롬프트(MariaDB [(none)]>)로 진입하게 됩니다.

새로운 사용자 생성 및 권한 부여

루트 계정으로 모든 작업을 수행하는 것은 보안상 좋지 않습니다. 따라서 특정 데이터베이스에만 접근 권한을 가진 새로운 사용자를 생성하는 것이 좋습니다. 다음은 ‘newuser’라는 사용자를 생성하고 ‘mypassword’ 비밀번호를 부여하는 예시 SQL 쿼리입니다.

CREATE USER 'newuser'@'localhost' IDENTIFIED BY 'mypassword'; GRANT ALL PRIVILEGES ON . TO 'newuser'@'localhost' WITH GRANT OPTION; FLUSH PRIVILEGES;
  • CREATE USER ...: 사용자 이름과 비밀번호를 설정합니다.
  • GRANT ALL PRIVILEGES ON . ...: 모든 데이터베이스(첫 번째 )와 모든 테이블(두 번째 )에 대해 모든 권한을 부여합니다. 운영 환경에서는 필요한 최소한의 권한만 부여해야 합니다.
  • FLUSH PRIVILEGES: 권한 테이블을 새로고침하여 변경 사항을 즉시 적용합니다.

사용자 생성 후에는 루트 접속을 끊고 (exit; 입력), 새로 만든 사용자로 접속하여 테스트해 볼 수 있습니다.

mysql -u newuser -p

Mac MariaDB 환경 설정 파일 위치 및 변경 관리 상세 더보기

MariaDB의 성능 튜닝이나 기본 설정을 변경해야 할 경우, 설정 파일(my.cnf)을 수정해야 합니다. Homebrew로 설치된 MariaDB의 설정 파일 위치는 일반적인 설치와 다소 차이가 있을 수 있습니다.

일반적으로 Homebrew를 통해 설치된 MariaDB의 설정 파일은 다음 경로 중 하나에 위치합니다.

  • /opt/homebrew/etc/my.cnf (M1/M2 Apple Silicon Mac의 기본 경로)
  • /usr/local/etc/my.cnf (Intel Mac의 기본 경로)

설정 파일이 해당 위치에 없다면, Homebrew는 기본적으로 설치 시 템플릿 파일을 제공합니다. 만약 파일이 없다면, 다음 명령어로 MariaDB 설정 파일이 위치하는 경로를 확인하거나 직접 파일을 생성할 수 있습니다.

mysql --help | grep "Default options" -A 1

my.cnf 파일을 편집기로 열어 [mysqld] 섹션에 원하는 설정을 추가하거나 수정할 수 있습니다. 예를 들어, 최대 연결 수를 늘리거나 문자셋을 UTF-8로 변경하는 작업 등을 수행합니다.

설정 파일 변경 후에는 반드시 MariaDB 서비스를 재시작해야 변경 사항이 적용됩니다.

brew services restart mariadb

이러한 설정 파일 관리를 통해 개발 환경에 최적화된 MariaDB 환경을 구축할 수 있습니다. 예를 들어, 개발 초기에는 로그 설정을 자세하게 하여 디버깅에 유리하게 만들 수 있습니다.

Mac용 MariaDB와 외부 DB 클라이언트 연결 확인하기

터미널 환경에서 SQL 쿼리를 실행하는 것은 기본적인 작업이지만, 보다 효율적인 데이터베이스 관리를 위해 GUI 기반의 외부 DB 클라이언트를 사용하는 것이 좋습니다. Mac에서 널리 사용되는 클라이언트로는 DBeaver, Sequel Ace(MySQL/MariaDB 전용), TablePlus 등이 있습니다.

이 클라이언트들을 MariaDB에 연결하려면 다음 정보가 필요합니다.

  • 호스트(Host): localhost 또는 127.0.0.1
  • 포트(Port): 기본값 3306 (설정을 변경하지 않았다면)
  • 사용자 이름(Username): 위에서 생성한 ‘newuser’ 또는 ‘root’
  • 비밀번호(Password): 설정한 비밀번호

클라이언트의 연결 설정 창에서 위 정보를 입력하고 연결을 시도합니다. 연결에 성공하면 GUI 환경에서 테이블 생성, 데이터 조회 및 수정 등의 작업을 시각적으로 편리하게 수행할 수 있습니다. 특히 복잡한 쿼리를 작성하고 결과를 분석할 때 GUI 클라이언트의 유용성은 극대화됩니다.

만약 연결에 문제가 발생한다면, MariaDB 서비스가 제대로 실행 중인지 (brew services list), 방화벽 설정이 포트 3306을 차단하고 있지 않은지, 그리고 설정 파일(my.cnf)에 bind-address 설정이 127.0.0.1 또는 주석 처리되어 있는지 확인해야 합니다.

자주 묻는 질문 (FAQ)

MariaDB와 MySQL의 차이점은 무엇이며, MariaDB를 선택하는 이유는 무엇인가요?

MariaDB는 MySQL의 공동 설립자가 오라클에 인수된 MySQL에 대한 대안으로 포크(Fork)한 버전입니다. 핵심적으로 높은 호환성을 유지하면서도, 더 나은 성능, 새로운 스토리지 엔진(예: Aria, XtraDB), 그리고 순수한 오픈 소스 라이선스(GPL)를 지향합니다. Mac 환경에서 개인 개발용이나 중소규모 프로젝트에는 MariaDB가 충분히 강력하고 안정적인 대안입니다.

Mac에서 Homebrew 대신 Docker로 MariaDB를 설치하는 것도 좋은 방법인가요?

네, Docker를 사용하는 것은 매우 좋은 대안이며, 2024년부터 2025년 현재까지도 컨테이너 기반 개발 환경 구축의 주요 트렌드입니다. Docker를 사용하면 Mac 시스템 환경을 깨끗하게 유지하면서, MariaDB 버전을 프로젝트별로 독립적으로 관리할 수 있습니다. 하지만 Homebrew는 Mac 네이티브 환경에 통합되어 시스템 서비스처럼 관리하기 편리하다는 장점이 있습니다. 사용자의 개발 목적과 선호도에 따라 선택할 수 있습니다.

MariaDB 서비스가 시작되지 않을 때(Started 에러) 해결 방법은 무엇인가요?

서비스 시작 실패의 가장 흔한 원인은 데이터 디렉토리의 권한 문제입니다. Homebrew 설치 후 M1/M2 Mac에서 종종 발생합니다. 터미널에서 다음 명령어를 실행하여 데이터 디렉토리의 소유권을 현재 사용자로 변경해 보세요. sudo chown -R $(whoami) /opt/homebrew/var/mysql (Apple Silicon 경로 기준, Intel Mac은 /usr/local/var/mysql). 권한 변경 후 brew services start mariadb를 다시 시도해 보세요. 또한, 이전에 설치된 MySQL이나 다른 MariaDB 버전이 3306 포트를 점유하고 있는지도 확인해야 합니다.

MariaDB의 기본 포트 3306을 변경하고 싶습니다. 어떻게 해야 하나요?

포트 번호 변경은 위에 설명된 설정 파일(my.cnf)을 수정하여 가능합니다. [mysqld] 섹션에 port = 3307와 같이 원하는 포트 번호를 추가하고, MariaDB 서비스를 재시작(brew services restart mariadb)하면 됩니다. 포트 변경은 보안상의 이유나 다른 서비스와의 충돌을 피하기 위해 유용합니다.

이 가이드가 Mac 환경에서 MariaDB를 성공적으로 설치하고 설정하는 데 도움이 되었기를 바랍니다. 데이터베이스 환경 구축을 완료했으니, 이제 본격적인 개발 작업을 시작할 수 있습니다.

Leave a Comment