ServBay 로컬 환경에서 ExpressionEngine CMS 설치 및 설정 가이드

개요

ExpressionEngine은 강력하고 유연한 콘텐츠 관리 시스템(CMS)으로, 다양한 유형의 웹사이트 및 웹 애플리케이션 구축에 널리 사용됩니다. 풍부한 핵심 기능과 모듈화된 아키텍처를 제공하여, 개발자와 디자이너가 원하는 대로 사이트를 자유롭게 설계·커스터마이즈할 수 있습니다.

ServBay는 macOS 전용으로 설계된 올인원 로컬 웹 개발 환경입니다. Nginx, Caddy, Apache와 같은 다양한 인기 웹 서버, PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET 등 여러 언어 런타임, MySQL, PostgreSQL, MongoDB, Redis 등 데이터베이스, 그리고 Composer, npm/yarn, phpMyAdmin/Adminer 등 개발 도구를 통합 제공합니다. ServBay를 활용하면 개발자는 로컬 개발 환경을 쉽고 빠르게 구축·관리할 수 있습니다.

이 문서에서는 ServBay 환경에서 ExpressionEngine을 설치·설정하는 방법을 단계별로 안내합니다. 이 가이드를 통해 ExpressionEngine 프로젝트를 신속하게 시작할 수 있습니다.

ServBay로 ExpressionEngine을 설치해야 하는 이유

ServBay를 이용해 로컬에 ExpressionEngine을 설치하면 다음과 같은 이점이 있습니다.

통합 환경: ServBay는 ExpressionEngine에 필요한 PHP 런타임, MySQL 데이터베이스, 웹 서버를 한번에 제공하므로 별도의 설치·설정이 필요 없습니다.
멀티 버전 지원: ServBay에서는 ExpressionEngine 버전에 따라 다양한 PHP 버전 간 손쉽게 전환하여 사용 가능합니다.
간편한 DB 관리: 내장된 phpMyAdmin 또는 Adminer를 이용해, ExpressionEngine용 데이터베이스를 쉽게 만들고 관리할 수 있습니다.
쉬운 사이트 설정: 직관적 GUI를 통해 ExpressionEngine 프로젝트 디렉터리를 가리키는 로컬 사이트를 빠르게 생성하고 설정할 수 있습니다.
격리 및 관리: 각 프로젝트별로 독립적인 사이트 구성이 가능해, 프로젝트 간 환경 충돌을 방지할 수 있습니다.

사전 준비사항

설치를 시작하기 전 아래 조건을 확인해 주세요.

macOS에 ServBay가 설치되어 실행 중이어야 합니다. 아직 설치하지 않았다면 ServBay 공식 홈페이지에서 설치 안내를 참고하세요.
터미널 명령어 사용에 대한 기초적인 이해가 필요합니다.
데이터베이스(데이터베이스, 사용자 등) 개념을 기본적으로 알고 있어야 합니다.
ServBay의 기본 웹사이트 루트 디렉터리 /Applications/ServBay/www에 쓰기 권한이 있어야 합니다.

설치 단계

ServBay 환경에서 ExpressionEngine을 설치·설정하는 과정은 다음과 같습니다.

1단계: 프로젝트 디렉터리 준비 및 ExpressionEngine 다운로드

먼저, 터미널을 실행합니다. ServBay의 기본 웹사이트 루트 디렉터리(/Applications/ServBay/www)로 이동해 새 프로젝트 폴더(예: servbay-ee-app)를 만들고 해당 폴더로 진입합니다.

bash

cd /Applications/ServBay/www
mkdir servbay-ee-app
cd servbay-ee-app

그 다음, curl 명령으로 최신 버전의 ExpressionEngine을 다운로드합니다. -L은 리다이렉션을 따라가고, -o는 출력 파일명을 지정합니다.

bash

curl -L https://expressionengine.com/latest -o expressionengine.zip

2단계: ExpressionEngine 파일 압축 해제

다운로드가 완료되면 unzip 명령을 사용해 expressionengine.zip 파일을 현 디렉터리에 해제합니다. 압축 해제 후, 더 이상 필요 없는 압축 파일은 삭제합니다.

bash

unzip expressionengine.zip
rm expressionengine.zip

압축 해제 후, servbay-ee-app 하위에 ExpressionEngine 파일 구조가 생성됩니다.

3단계: ExpressionEngine용 데이터베이스 및 사용자 생성

ExpressionEngine은 콘텐츠와 설정 정보를 저장할 데이터베이스가 필요합니다. ServBay에 내장된 MySQL과 phpMyAdmin를 이용해 관리할 수 있습니다.

ServBay 제공 phpMyAdmin 접속
웹 브라우저를 열고 ServBay 로컬 툴 접속 URL https://servbay.host/로 이동하세요. 페이지에서 「phpMyAdmin」 링크를 찾아 클릭하면 로그인 페이지로 이동합니다. ServBay 기본 DB 계정 및 비밀번호(ServBay 데이터베이스 설정에서 안내, 보통 기본 설치 시 비밀번호 없이 localhost 접근 가능)를 사용해 로그인합니다.
DB 사용자 및 데이터베이스 생성
로그인 후, ExpressionEngine 전용 DB 계정과 데이터베이스를 생성합니다.
- 사용자 계정 탭 진입: phpMyAdmin 메인에서 상단 메뉴의 「사용자 계정」(User Accounts) 클릭
- 새 사용자 추가: 「사용자 계정 추가」(Add user account)
- 계정 정보 입력:
  - 사용자명: 예시로 ee_user 입력
  - 호스트명: localhost 선택(보안을 위해 로컬 접속만 허용)
  - 비밀번호: 안전한 비밀번호 입력(예: password123은 예시이며, 실제 환경에선 반드시 강력한 비밀번호 사용)
  - 비밀번호 재입력: 다시 입력
  - DB 자동 생성: 「사용자명과 동일한 이름의 데이터베이스 생성 및 모든 권한 부여」 항목 체크
- 권한 확인: "글로벌 권한" 항목에서 불필요한 권한은 체크하지 않아도 됩니다(자동 권한 부여 완료).
- 실행: 하단 "실행"(Go) 버튼 클릭하여 DB 및 사용자 생성 완료
이제 ee_user라는 이름의 데이터베이스와, 해당 DB에 모든 권한이 부여된 동명의 사용자(ee_user)가 준비되었습니다.

4단계: ServBay에서 사이트 구성

이제 ServBay에게 특정 도메인(예: servbay-ee.local)으로의 요청을 ExpressionEngine 프로젝트 폴더로 연결하도록 설정해야 합니다.

ServBay에서 신규 웹사이트 추가
ServBay 앱의 그래픽 인터페이스를 엽니다. 왼쪽 메뉴에서 「웹사이트」로 이동 후, 상단의 「+」 또는 「추가」 버튼을 클릭합니다.
- 이름(Name): 예시로 My ExpressionEngine Site와 같이 식별하기 쉬운 이름 입력
- 도메인(Domain): 예: servbay-ee.local 입력 — ServBay가 hosts 파일을 자동으로 수정해 이 도메인이 127.0.0.1로 연결되도록 설정
- 사이트 타입(Type): PHP 선택(ExpressionEngine은 PHP 기반)
- PHP 버전: 다운로드한 ExpressionEngine 요구 버전에 맞는 PHP 버전 선택 가능
- 문서 루트(Document Root): 탐색 버튼 클릭 후, 1단계에서 생성한 /Applications/ServBay/www/servbay-ee-app 경로 선택
- 웹 서버(Web Server): Nginx, Caddy, Apache 등 ServBay가 지원하는 서버 중 선택(일반적으로 기본값 사용 가능, 자동 설정)
설정 저장 및 적용
모든 정보를 입력하면 「저장」 또는 「적용」 클릭합니다. ServBay는 필요 시 웹 서버를 자동 재시작하여 새 구성을 반영합니다. 안내에 따라 진행하면 됩니다.
이제 브라우저에서 https://servbay-ee.local/로 접속 시 ExpressionEngine 프로젝트의 index로 라우팅됩니다.

5단계: ExpressionEngine 웹 기반 설치 프로그램 실행

ExpressionEngine은 웹 설치 마법사를 통해 최종 설정을 쉽게 안내합니다.

설치 페이지 접속
브라우저에서 ServBay에서 설정한 도메인 뒤에 admin.php를 붙여 접속합니다. 기본적으로 설치 진입 파일은 /admin.php입니다.
접속 예시: https://servbay-ee.local/admin.php
정상적으로 페이지가 보이면 ExpressionEngine 환영 페이지/설정 마법사가 표시됩니다.
설치 마법사 안내에 따라 정보 입력
설치 마법사에서는 아래 주요 정보를 입력하게 됩니다.
- DB 접속 정보:
  - 데이터베이스 호스트: localhost
  - 데이터베이스명: ee_user (3단계에서 만든 DB명)
  - DB 사용자명: ee_user (3단계에서 만든 사용자명)
  - DB 비밀번호: 3단계에서 설정한 비밀번호
- 관리자 계정: ExpressionEngine 관리자 아이디, 비밀번호, 이메일 등 입력(보안을 위해 강력한 패스워드 사용 권장)
- 사이트 설정: 사이트 이름, URL 등 기본 정보 입력
설치 완료
입력한 내용을 확인한 후, 마법사의 「설치」 또는 「완료」 버튼을 클릭하세요. ExpressionEngine이 필요 테이블을 자동 생성하고 기본 설정을 마칩니다.
설치가 끝나면 대개 로그인 페이지 또는 관리자 대시보드로 자동 이동합니다.

6단계: 설치 이후 기본 설정

ExpressionEngine 핵심 설치 후, 플러그인이나 템플릿 등 추가 설정을 진행할 수 있습니다.

ExpressionEngine 백오피스 로그인
설치 과정에서 만든 관리자 계정 정보로 https://servbay-ee.local/admin.php에서 로그인합니다.
플러그인 설치
백오피스에서 「개발자(Developer)」→「애드온(Add-Ons)」→「플러그인(Plugins)」으로 이동, 원하는 플러그인을 찾아 설치합니다.
템플릿 설치 및 설정
「디자인(Design)」→「템플릿(Templates)」 경로로 이동해 템플릿 그룹 및 개별 템플릿을 생성·설정할 수 있습니다. 여기서 웹사이트 콘텐츠 렌더링에 필요한 HTML, CSS, EE 코드 등을 자유롭게 작성할 수 있습니다.

ExpressionEngine로 웹사이트 구축 시작하기

이제 ServBay 환경에 ExpressionEngine을 성공적으로 설치하고 설정하셨습니다. 이제 본격적으로 사이트 구축 및 콘텐츠 관리를 시작해볼 수 있습니다. 주요 시작 예시를 안내합니다.

채널 및 항목 생성

ExpressionEngine의 핵심은 "채널"과 "항목"입니다. 채널은 콘텐츠의 유형과 구조를 정의하고, 항목은 구체적 콘텐츠 인스턴스입니다.

채널 생성: 관리백오피스에서「콘텐츠 구조(Content Structure)」→「채널 관리(Channels)」로 이동, 「새 채널 생성(Create New Channel)」 클릭 후, 채널명, 필드 그룹 등 작성 후 「채널 저장(Save Channel)」 클릭
항목 생성: 「콘텐츠(Content)」→「게시(Publish)」에서 방금 만든 채널 선택 후, 항목 제목/내용 등 작성 및 「저장(Save)」 클릭

내비게이션 메뉴 구성

내비 메뉴(메뉴바 등)는 템플릿으로 구현하는 것이 보통입니다.

템플릿 생성/편집: "디자인(Design)"→"템플릿(Templates)"에서, site와 같이 내비게이션 용도의 템플릿 그룹에 nav 템플릿 생성
내비게이션 코드 작성: ExpressionEngine 템플릿 태그를 활용해, 채널 엔트리나 페이지 정보를 조회하여 HTML 내비 구조를 구현
레이아웃에 내비게이션 포함: 주요 페이지 레이아웃 템플릿에 {% include 'site:nav' %}(Blade 엔진 사용 시) 또는 기타 태그로 내비게이션을 포함시킴

위젯(사이드바) 커스터마이즈

내비게이션과 마찬가지로, 사이드바·위젯 등 기타 영역도 템플릿으로 구현합니다.

위젯 템플릿 생성: "디자인(Design)"→"템플릿(Templates)"에서 site:sidebar 등으로 위젯용 템플릿 생성
위젯 코드 작성: 최신 글/카테고리 목록/광고 등 보여줄 콘텐츠를 위한 템플릿 코드 작성
레이아웃에 포함: 원하는 위치에 위젯 템플릿을 포함시켜 배치

자주 묻는 질문 (FAQ)

Q: https://servbay-ee.local/ 접속 시 권한 오류가 발생해요.
- A: ExpressionEngine 프로젝트 폴더(/Applications/ServBay/www/servbay-ee-app) 및 하위 폴더/파일의 권한을 확인하세요. ServBay를 실행하는 사용자(대부분 본인)에게 읽기·쓰기 권한이 있어야 합니다. 아래와 같은 명령으로 권한을 변경할 수 있습니다.
bash
```
sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app
```
1
Q: ExpressionEngine 설치 마법사에서 데이터베이스 연결 오류가 납니다.
- A: 설치 마법사에 입력한 DB 정보(호스트: localhost, DB명, 사용자명, 비밀번호)가 phpMyAdmin에서 만든 정보와 정확히 일치하는지 확인하세요. ServBay의 MySQL/MariaDB 서비스가 정상 실행 중인지도 체크하세요.
Q: ServBay의 다른 데이터베이스(PostgreSQL 등)도 사용 가능한가요?
- A: ExpressionEngine은 원칙적으로 MySQL/MariaDB를 중심으로 지원합니다. 공식적으로 PostgreSQL이 지원되고, 필요한 드라이버와 설정 방법이 있다면, ServBay의 PostgreSQL 서비스도 활용할 수 있습니다. 자세한 지원 여부는 ExpressionEngine 공식 문서를 참고하세요.

정리

이 가이드의 단계를 그대로 따라오셨다면, ServBay 로컬 개발 환경에서 ExpressionEngine CMS를 성공적으로 설치·설정하셨을 것입니다. ServBay는 ExpressionEngine의 개발에 최적화된 편리하고 효율적인 환경을 제공하며, 필요한 모든 구성 요소까지 통합되어 있습니다. 이제 ExpressionEngine의 다양한 기능을 마음껏 활용해 본인만의 웹사이트·웹 애플리케이션을 시작해보세요. 성공적인 개발을 응원합니다!

ServBay 로컬 환경에서 ExpressionEngine CMS 설치 및 설정 가이드 ​

개요 ​

ServBay로 ExpressionEngine을 설치해야 하는 이유 ​

사전 준비사항 ​

설치 단계 ​

1단계: 프로젝트 디렉터리 준비 및 ExpressionEngine 다운로드 ​

2단계: ExpressionEngine 파일 압축 해제 ​

3단계: ExpressionEngine용 데이터베이스 및 사용자 생성 ​

4단계: ServBay에서 사이트 구성 ​

5단계: ExpressionEngine 웹 기반 설치 프로그램 실행 ​

6단계: 설치 이후 기본 설정 ​

ExpressionEngine로 웹사이트 구축 시작하기 ​

채널 및 항목 생성 ​

내비게이션 메뉴 구성 ​

위젯(사이드바) 커스터마이즈 ​

자주 묻는 질문 (FAQ) ​

정리 ​

ServBay 로컬 환경에서 ExpressionEngine CMS 설치 및 설정 가이드

개요

ServBay로 ExpressionEngine을 설치해야 하는 이유

사전 준비사항

설치 단계

1단계: 프로젝트 디렉터리 준비 및 ExpressionEngine 다운로드

2단계: ExpressionEngine 파일 압축 해제

3단계: ExpressionEngine용 데이터베이스 및 사용자 생성

4단계: ServBay에서 사이트 구성

5단계: ExpressionEngine 웹 기반 설치 프로그램 실행

6단계: 설치 이후 기본 설정

ExpressionEngine로 웹사이트 구축 시작하기

채널 및 항목 생성

내비게이션 메뉴 구성

위젯(사이드바) 커스터마이즈

자주 묻는 질문 (FAQ)

정리