이 글에서는 macOS 환경에 MySQL을 설치하는 전체 과정을 단계별로 자세히 알아보겠습니다. 초보자도 쉽게 따라 할 수 있도록 설치 전 준비 사항부터 설치 후 구성 설정까지 순서대로 정리했습니다.
설치 전 준비 사항
MySQL은 디스크 이미지(.dmg) 파일 형태로 배포됩니다. Finder에서 해당 아이콘을 더블클릭하면 이미지가 마운트되며, 내부 파일 내용을 확인할 수 있습니다.
MySQL을 설치하기 전에는 반드시 실행 중인 모든 MySQL 서버 인스턴스를 종료해야 합니다. 종료 방법은 다음과 같습니다.
- macOS 서버에 포함된 MySQL 관리자 애플리케이션 사용
- 시스템 환경설정의 MySQL 환경설정 패널(Preference Pane) 사용
- 터미널에서
mysqladmin shutdown명령어 실행
패키지 인스톨러로 MySQL 설치하기
MySQL은 공식 패키지 인스톨러를 통해 간편하게 설치할 수 있습니다. 아래 절차를 따라 진행해 보세요.
1. 설치 파일 다운로드
먼저 MySQL 커뮤니티 버전이 포함된 디스크 이미지(.dmg) 파일을 다운로드해야 합니다. 이 파일 안에 MySQL 패키지 인스톨러가 들어 있습니다. 아래 스크린샷과 같이 MySQL 공식 웹사이트에서 다운로드할 수 있습니다.
2. 설치 패키지 실행
다운로드한 MySQL 인스톨러 패키지를 더블클릭하여 실행합니다.
3. 설치 마법사 진행
패키지 이름은 다운로드한 MySQL 버전에 따라 결정됩니다. 예를 들어 MySQL 서버 버전이 8.0.22라면 파일명은 mysql-8.0.22-osx-10.13-x86_64.pkg와 같습니다.
- 마법사의 첫 화면(소개 화면)에서 설치하려는 MySQL 서버 버전을 확인할 수 있습니다.
- ‘계속’(Continue) 버튼을 클릭해 패키지 설치를 시작합니다.
- MySQL 커뮤니티 에디션의 경우 관련 GNU 일반 공중 사용 허가서(GPL) 사본이 표시됩니다.
- ‘계속’(Continue)을 클릭한 뒤 ‘동의’(Agree)를 눌러 진행합니다.
4. 설치 유형 선택
‘설치 유형’(Installation Type) 페이지에서는 두 가지 방식 중 하나를 선택할 수 있습니다.
- ‘설치’(Install): 모든 기본 설정값을 그대로 사용하여 설치 마법사를 실행합니다.
- ‘사용자화’(Customize): 설치할 구성 요소를 직접 선택합니다(MySQL 서버, MySQL Test, 환경설정 패널, Launchd 지원 등 — 기본적으로 MySQL Test를 제외한 나머지는 모두 활성화되어 있습니다).
- ‘설치 위치 변경’(Change Install Location) 옵션이 표시되지만, 실제로는 설치 위치를 변경할 수 없습니다.
- ‘설치’(Install) 버튼을 클릭하면 MySQL 서버 설치가 시작됩니다.
설치 후 초기 구성 설정
기존에 설치된 MySQL 서버를 업그레이드하는 경우라면 여기서 설치 과정이 끝나지만, 새로 설치하는 경우라면 마법사의 추가 구성 단계를 계속 진행해야 합니다.
MySQL 서버 설치가 성공적으로 완료되면 다음 구성 항목들을 설정해야 합니다.
- 비밀번호 암호화 방식 선택: MySQL 8.0의 기본 비밀번호 메커니즘은
caching_sha2_password(강력한 암호화)입니다. 필요에 따라 이전 버전 호환용인mysql_native_password(레거시)로 변경할 수도 있습니다. - 레거시 암호화 방식을 선택하면 생성된 launchd 파일의 ProgramArguments 항목에
--default_authentication_plugin=mysql_native_password옵션이 추가됩니다. - 반대로 강력한 암호화를 선택하면
--default_authentication_plugin옵션이 별도로 설정되지 않습니다. MySQL 서버의 기본값이 이미caching_sha2_password이기 때문입니다.
- root 계정 비밀번호 설정: root 사용자에게 사용할 비밀번호를 지정합니다.
- 서버 자동 시작 여부: 구성 단계가 완료된 후 MySQL 서버를 자동으로 시작할지 여부를 토글로 선택할 수 있습니다.
마지막 ‘요약’(Summary) 화면이 표시되면 MySQL 서버 설치가 성공적으로 완료된 것입니다. 마법사를 닫으면 됩니다.
설치 위치 및 참고 사항
패키지 인스톨러로 설치를 완료하면 관련 파일들이 설치 버전과 플랫폼 이름에 해당하는 /usr/local 하위 디렉터리에 저장됩니다.
예를 들어, 설치 파일이 mysql-8.0.25-osx10.15-x86_64.dmg라면 MySQL은 /usr/local/mysql-8.0.25-osx10.15-x86_64/ 경로에 설치되고, /usr/local/mysql로 연결되는 심볼릭 링크(symlink)가 함께 생성됩니다.
만약 부팅 시 MySQL 자동 시작을 선택하지 않았다면, 터미널에서 launchctl 명령어를 사용하거나 MySQL 환경설정 패널에서 ‘시작’(Start) 버튼을 클릭하여 서버를 수동으로 시작할 수 있습니다.
참고로 macOS 설치 프로세스는 샘플 my.cnf MySQL 구성 파일을 자동으로 생성하거나 설치하지 않으므로, 필요한 경우 직접 작성해야 한다는 점을 기억해 두세요.