ServBay 설치 가이드: macOS에서 빠르게 로컬 웹 개발 환경 구축하기

ServBay는 개발자를 위해 설계된 로컬 웹 개발 환경 도구로, macOS에서 다양한 기술 스택(PHP, Node.js, Python, Go, Java, Ruby, Rust 등)과 데이터베이스(MySQL, PostgreSQL, MongoDB, Redis 등)를 쉽고 편리하게 설치·관리할 수 있도록 도와줍니다. 심플하고 빠른 설치 과정은 ServBay의 가장 큰 장점 중 하나입니다.

다른 유사 도구에 비해 ServBay 설치 파일은 매우 작으며(평균 20MB 내외), 전체 설치부터 초기 설정까지 몇 번의 클릭으로 단 몇 분 만에 완료할 수 있습니다. 이를 통해 개발에 바로 집중할 수 있습니다.

동영상 가이드

이 영상에서는 ServBay의 설치 과정을 단계별로 자세히 안내합니다. 직접 YouTube에서 시청하실 수도 있습니다.

중요 안내 및 사전 준비 사항

ServBay는 현재 macOS 운영체제에서만 주로 지원됩니다.

설치 및 초기화 전에 아래의 중요한 내용을 꼭 확인해 주세요.

• 포트 충돌: 운영체제의 포트는 한 번에 하나의 프로세스만 사용할 수 있습니다. ServBay가 구동되려면 웹 서버, 데이터베이스 등 주요 서비스가 특정 포트를 사용해야 하므로, 설치 전에 ServBay가 필요로 하는 포트를 점유 중인 프로그램이 있다면 반드시 종료해 주세요. 흔히 충돌이 발생하기 쉬운 포트는 다음과 같습니다(이외에도 충돌할 수 있음):
  • 웹 서비스 포트: 80 (HTTP), 443 (HTTPS) (주요 점유 프로그램: Apache, Nginx, Caddy, 기타 로컬 웹서버)
  • MySQL/MariaDB 데이터베이스 포트: 3306
  • PostgreSQL 데이터베이스 포트: 5432
  • MongoDB 데이터베이스 포트: 27017
  • Redis 서비스 포트: 6379
  • DNS 서비스 포트: 53 (주요 점유 프로그램: dnsmasq, 기타 로컬 DNS 서비스) 터미널에서 lsof -i :[포트번호] 명령어(예: lsof -i :80)로 해당 포트를 사용하는 프로세스를 확인하실 수 있습니다.

ServBay 설치 파일 다운로드

ServBay 설치 파일의 최신 버전은 공식 웹사이트 다운로드 페이지에서 받을 수 있습니다. 파일 용량이 작아 빠르게 다운로드할 수 있습니다.

ServBay 다운로드 페이지에서 macOS용 .dmg 설치 파일을 내려받아 주세요. 파일명은 보통 ServBayInstaller-vX.Y.Z.dmg 형태이며, X.Y.Z는 버전 번호를 의미합니다.

ServBay 설치 방법

다운로드가 완료되면 아래 단계에 따라 설치를 진행하세요.

1. 다운로드한 .dmg 설치 파일(예: ServBayInstaller-v1.12.0.dmg)을 더블 클릭합니다. 그러면 디스크 이미지가 마운트되고 설치 창이 열립니다.
2. 설치 창에서는 ServBay.app 아이콘과 응용 프로그램 폴더(Applications) 바로가기가 보입니다. ServBay.app 아이콘을 응용 프로그램 폴더로 드래그하면 설치가 완료됩니다.
3. 설치 후, macOS의 ‘응용 프로그램’ 폴더에서 ServBay 아이콘을 찾아 더블 클릭하면 프로그램이 실행됩니다.

ServBay 초기 설정

ServBay를 처음 실행할 때는 초기 설정이 필요합니다. 이 과정에서 선택한 옵션에 따라 필요한 소프트웨어 패키지가 다운로드되고 자동으로 설정됩니다. 반드시 모든 필수 포트가 비어 있는지 확인한 뒤 ServBay 아이콘을 실행해 주세요.

ServBay는 직관적인 초기화 화면을 제공합니다.

1. 개발자 유형 선택: 초기화 화면 왼쪽에서 ‘Web Developer’, ‘Full Stack Developer’, ‘PHP Developer’ 등 본인의 주요 개발 목적에 맞는 역할을 선택하세요.
2. 추천 패키지 확인: 역할을 선택하면, 우측에서 ServBay가 해당 역할에 맞게 미리 추천하는 패키지 조합이 표시됩니다. 기본 웹 서버(예: Nginx), ServBay 런타임, 선택한 언어(예: PHP, Python 등) 버전이 포함됩니다. 기본 옵션을 확인하세요.
3. 설치 시작: 역할과 추천 패키지를 확인했다면 오른쪽 하단 Start Installation 버튼을 클릭하여 설치를 시작합니다.
4. 권한 요청: "Start Installation" 클릭 후, ServBay는 macOS 현재 사용자 비밀번호 입력을 요청합니다. 이는 ServBay Helper 툴 설치를 위해 필요합니다. ServBay Helper는 시스템 서비스 관리, 권한 및 포트 바인딩 등 하위 작업에 필수인 보조 도구입니다. 반드시 ServBay Helper 설치를 허용해야 하며, 거절 시 ServBay가 정상 동작하지 않습니다.
5. 설치 대기: 선택한 패키지 수와 네트워크 속도에 따라 몇 분 정도 설치, 다운로드, 설정 과정이 진행됩니다. 잠시 기다려 주세요.
6. 메인 화면 진입: 초기화가 성공적으로 완료되면 ServBay 메인 대시보드가 자동으로 나타납니다. 여기서 설치된 패키지의 상태를 한눈에 확인할 수 있습니다.

축하합니다! ServBay가 성공적으로 설치 및 초기 설정되었습니다.

기본 데모 사이트 및 관리 도구 접속

ServBay는 기본적으로 데모용 웹사이트와, 데이터베이스 관리 도구(phpMyAdmin, Adminer 등), PHP 정보 페이지(phpinfo)를 내장하고 있어 설치 결과를 바로 확인하고 데이터베이스를 관리할 수 있습니다.

ServBay 기본 웹사이트 루트 디렉터리는 대체로 /Applications/ServBay/www입니다. 데모 사이트 및 각종 도구도 이 폴더에 위치합니다. 별도의 프로젝트도 이 디렉터리 하위 폴더에 배치하여 개발하실 수 있습니다.

• 웹 브라우저를 열고 기본 주소 https://servbay.host에 접속하세요.
  • ServBay 메인 화면 좌측 메뉴의 웹사이트 탭에서 servbay.host 사이트 항목을 클릭한 후 오른쪽의 방문 아이콘을 눌러 접근할 수도 있습니다.
• 열린 ServBay 데모 사이트에서는 phpMyAdmin, Adminer 등 각종 관리 도구로 바로 이동할 수 있는 링크를 찾을 수 있습니다.

이로써 ServBay를 설치·초기화하고, 기본 데모 사이트 및 관리 도구에 접속하는 방법까지 익히셨습니다. 이제 본인의 개발 프로젝트를 자유롭게 설정하여 시작해 보세요!