macOS의 ServBay 환경에서 Joomla CMS 설치 및 설정하기

개요

이 가이드는 강력한 로컬 웹 개발 환경인 ServBay에서 Joomla 콘텐츠 관리 시스템(CMS)을 설치하고 설정하는 방법을 상세히 설명합니다. ServBay는 PHP, MySQL 등 관련 기술 스택을 통합하고 쉽게 사용할 수 있도록 해줘 Joomla 웹사이트를 구축하고 테스트하는 데 매우 적합합니다. ServBay를 통해 다양한 PHP 버전, 데이터베이스, 웹서버(Caddy 혹은 Nginx)를 간편하게 관리할 수 있어, Joomla 개발에 유연하고 효율적인 기반을 제공합니다.

Joomla란 무엇인가요?

Joomla는 PHP로 개발된 널리 사용되는 오픈 소스 콘텐츠 관리 시스템(CMS)이며, 일반적으로 MySQL 데이터베이스를 사용합니다. 다양한 기능과 뛰어난 확장성을 갖추고 있어 개인 블로그, 중소기업 사이트부터 대규모 기업 포털, 전자상거래 플랫폼까지 폭넓게 활용할 수 있습니다. 활발한 커뮤니티 지원과 수많은 확장·템플릿 리소스를 제공해 웹사이트 개발, 관리, 유지보수를 보다 효과적으로 할 수 있습니다.

활용 사례

로컬 ServBay 환경에서 Joomla 웹사이트를 구축하여 개발, 테스트, 디버깅 작업 수행
Joomla의 기능 및 확장 개발 학습 및 탐구
오프라인에서도 Joomla 프로젝트 진행
추후 운영 환경 배포를 위한 Joomla 설정 준비

사전 준비 사항

Joomla 설치를 시작하기 전에 아래 사항을 미리 준비해 주세요:

ServBay가 설치 및 실행 중이어야 합니다: macOS에 ServBay를 정상적으로 설치하고 실행하세요. ServBay는 Joomla 구동에 필요한 PHP, 웹서버(Caddy 또는 Nginx), 데이터베이스(MySQL 또는 MariaDB) 환경을 제공합니다.
기본 터미널 조작법 숙지: 설치 과정에서 터미널에서 몇 가지 기본 명령을 실행해야 합니다.
인터넷 연결: Joomla 설치 파일을 다운로드하려면 인터넷에 연결되어 있어야 합니다.

Joomla 설치 절차

다음 단계를 따라 ServBay 환경에서 Joomla를 설치 및 설정하세요.

1단계: Joomla 다운로드

먼저, ServBay에서 권장하는 기본 웹사이트 루트 디렉터리 /Applications/ServBay/www로 이동하세요. 이곳은 로컬 사이트 프로젝트 관리를 위한 중심 위치입니다. 이 디렉터리 아래에 Joomla 웹사이트용 새 프로젝트 폴더를 만들고, Joomla 설치 파일을 다운로드합니다.

bash

# ServBay 웹사이트 루트로 이동
cd /Applications/ServBay/www

# 새 프로젝트 폴더 생성(예: servbay-joomla-app)
mkdir servbay-joomla-app

# 새 폴더로 이동
cd servbay-joomla-app

# Joomla 설치 파일 다운로드
# 참고: 아래 링크는 Joomla 3의 최신 버전일 수 있습니다.
# 최신 버전은 Joomla 공식 웹사이트(https://downloads.joomla.org/)에서 직접 다운로드 링크를 확인하세요.
curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip

참고: curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip 명령에서 다운로드되는 파일은 작성 시점에 Joomla 3 최신 버전일 수 있습니다. Joomla는 새로운 버전(Joomla 4, 5 등)을 지속적으로 출시하므로, 반드시 Joomla 다운로드 공식 페이지에서 최신 안정 버전의 직접 다운로드 링크를 확인 후 위 명령의 URL을 교체하여 최신 기능과 보안 패치를 받으시길 권장합니다.

2단계: Joomla 압축 풀기

다운로드한 Joomla 압축 파일을 현재 servbay-joomla-app 폴더로 풀고, 정리를 위해 압축 파일은 삭제합니다.

bash

# Joomla 압축 파일 풀기
unzip joomla.zip

# 압축 파일 삭제
rm joomla.zip

압축이 완료되면, servbay-joomla-app 폴더 내에 Joomla의 전체 설치 파일이 준비됩니다.

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

Joomla는 콘텐츠, 설정, 사용자 정보를 저장할 데이터베이스가 필요합니다. ServBay에 내장된 phpMyAdmin 도구를 이용해 데이터베이스와 전용 사용자 계정을 만들어봅니다.

ServBay 제어판 접속
웹 브라우저를 열고 ServBay의 로컬 제어판 주소인 https://servbay.host/에 접속하세요. 여기서 phpMyAdmin, phpinfo 등 주요 도구에 접근할 수 있습니다.
phpMyAdmin 진입
ServBay 제어판 페이지에서 [phpMyAdmin] 링크를 클릭하면 데이터베이스 관리 화면이 열립니다.
데이터베이스 사용자 생성
각 애플리케이션마다 별도의 데이터베이스 사용자를 생성하는 것이 보안상 권장됩니다.
1. 사용자 계정 관리로 이동
  phpMyAdmin 상단 메뉴에서 ‘사용자 계정’ 항목을 클릭하세요.
2. 새 사용자 계정 추가
  ‘사용자 계정 추가’를 클릭하고 아래와 같이 입력하세요:
  - 사용자 이름: 원하는 데이터베이스 사용자명(ex: servbay_joomla_user)
  - 호스트명: localhost로 선택 (로컬 접속만 허용 ⇒ 보안 강화)
  - 비밀번호: 강력한 비밀번호 입력. 꼭 기록해 두세요. 예시로 password123 사용할 수 있으나, (실제 사용 시 더 복잡하게 설정)
  - 비밀번호 재입력: 위와 동일하게 입력해 확인
  - 유저와 동일한 이름의 데이터베이스 생성 + 모든 권한 부여: ‘사용자 이름과 동일한 데이터베이스 생성 및 모든 권한 부여’ 항목을 체크. 자동으로(예: servbay_joomla_user) 데이터베이스를 만들고 해당 유저에게만 권한을 부여합니다.
  - 전역 권한: ‘모든 권한 부여’의 전역 권한 옵션은 체크하지 않습니다. 오로지 본인 데이터베이스에만 관리 권한을 줄 것입니다.
3. 생성 실행
  모든 사항이 올바른지 확인 후, 아래의 ‘실행’ 버튼을 눌러 유저와 데이터베이스 생성을 완료합니다.

4단계: 웹서버 설정(사이트 추가)

이번엔 ServBay에 새 도메인을 설정하여 Joomla 파일에 접근할 수 있게 웹서버에 ‘사이트’를 추가합니다.

ServBay 앱 실행
ServBay 애플리케이션을 실행(혹은 활성화)합니다.
사이트(웹사이트) 관리 진입
ServBay 인터페이스 좌측 내비게이션 메뉴에서 ‘사이트’ 탭 클릭.
새 웹사이트 추가
우측 상단 ‘추가’ 버튼 클릭.
- 이름(Name): 예시로 My ServBay Joomla Site
- 도메인(Domain): 브라우저에서 접속할 로컬 도메인(ex: servbay-joomla.local). ServBay에서 로컬 DNS를 자동 설정하여 이 도메인을 본인 맥 환경으로 연결해줍니다.
- 사이트 유형(Site Type): PHP 선택
- PHP 버전(PHP Version): 사용하고자 하는 PHP 버전을 선택. 다운로드한 Joomla 버전과의 호환성을 꼭 확인(권장/호환 버전 사용)
- 사이트 루트(Site Root): 폴더 아이콘 클릭 후, 1단계에서 생성한 /Applications/ServBay/www/servbay-joomla-app 프로젝트 폴더를 선택하세요.
설정 저장
모든 항목 입력을 마쳤으면 하단 ‘저장’ 버튼 클릭. ServBay가 신규 사이트 설정을 적용하며, (Caddy/Nginx 등) 관련 서비스가 잠시 재시작할 수 있습니다.

5단계: Joomla 설치 마법사 실행

이제, 앞서 설정한 로컬 도메인으로 Joomla 웹 설치 화면에 접속할 수 있습니다.

설치 페이지 접속
웹 브라우저에서 4단계에서 설정한 도메인(예: https://servbay-joomla.local/)으로 들어가세요. ServBay가 해당 디렉터리의 파일로 요청을 안내합니다. Joomla는 첫 접속 시 자동으로 설치 마법사(대개 /installation/index.php)로 리디렉션합니다. 리디렉션이 안되면 https://servbay-joomla.local/installation/index.php 경로로 직접 접속하세요.
설치 마법사 따라하기
Joomla의 그래픽 기반 설치 마법사가 나오면 화면 지시에 따라 차례대로 입력합니다.
- 환경설정(Configuration): 사이트 이름, 설명, 관리자 계정(사용자명, 비밀번호, 이메일 등) 입력. 보안을 위해 강력한 관리자 계정 및 비밀번호 사용 필수
- 데이터베이스(Database): 3단계에서 만든 계정정보 입력
  - 데이터베이스 유형(Database Type): 보통 MySQLi 선택
  - 호스트명(Host Name): localhost 입력
  - 사용자명(Username): 예시 servbay_joomla_user
  - 비밀번호(Password): 예시 password123
  - 데이터베이스명(Database Name): 예시 servbay_joomla_user
  - 테이블 접두사(Table Prefix): 랜덤 자동 생성값 사용 또는 직접(ex: jos_) 설정 가능
  - 기존 DB 처리(Action on Old Database): 신규 설치라면 ‘백업’이나 ‘삭제’ 선택(공 DB일 경우 큰 영향 없음)
- 최종확인(Finalisation): 모든 설정 정보 확인. Joomla가 환경 체크 후 문제 없으면 ‘설치’ 클릭
설치 완료 후 설치 디렉터리 삭제
설치가 몇 분 소요 될 수 있습니다. 설치 완료되면 성공 메시지가 나오며, 반드시 installation 폴더를 삭제해야 합니다. 이는 보안상 중요하여, 설치 화면에서도 안내 버튼이 제공됩니다.
터미널로 직접 삭제하려면:
bash
```
# Joomla 프로젝트 폴더로 이동
cd /Applications/ServBay/www/servbay-joomla-app

# installation 폴더 삭제
rm -rf installation
```
1
2
3
4
5
installation 폴더 삭제 후에는 Joomla 사이트에 정상 접속할 수 있습니다. 이제 프론트엔드(메인 사이트)와 관리자 백엔드 중 원하는 곳을 들어가면 됩니다.

6단계: Joomla 관리자 백엔드 탐색

본인 사이트 도메인 뒤에 /administrator(예: https://servbay-joomla.local/administrator)를 붙여 접속하면 Joomla 관리자 백엔드 로그인 화면이 나옵니다. 설치 시 만든 관리자 계정으로 로그인 후, 사이트 설정, 확장/템플릿 설치, 콘텐츠 작성 등을 시작할 수 있습니다.

Joomla로 웹사이트 구축하기 (간단 소개)

설치를 끝냈다면 다양한 Joomla의 강력한 기능을 활용하여 본격적으로 사이트를 만들어 볼 수 있습니다. 아래는 필수 입문 작업입니다.

글 및 분류 생성: ‘콘텐츠’ 메뉴에서 글 및 카테고리 관리
메뉴 관리: ‘메뉴’ 메뉴에서 웹사이트 네비게이션 메뉴 생성 및 편집
모듈 설정: ‘확장’ → ‘모듈’에서 사이드바, 푸터 등 각종 영역에 기능 모듈 배치 관리
템플릿 선택/커스터마이징: ‘확장’ → ‘템플릿’에서 전체 사이트 디자인 및 스타일 커스터마이즈
확장 설치: ‘확장’ → ‘관리’에서 컴포넌트, 모듈, 플러그인, 템플릿 등 새로운 확장 기능 설치

주의 사항

보안: Joomla 관리자 계정과 DB 사용자는 반드시 강력한 비밀번호를 사용하세요. 설치 직후 즉시 installation 디렉터리 삭제!
PHP 버전 호환성: ServBay에서 Joomla 사이트용 PHP 버전이 설치할 Joomla 버전과 반드시 호환됨을 확인(공식 문서 참조)
DB 연결 정보: Joomla 설치 중 데이터베이스 호스트명(localhost), DB 사용자명, 비밀번호, DB명을 정확히 입력할 것
ServBay 업데이트: ServBay를 주기적으로 최신 버전으로 업데이트하여 최첨단 패키지와 보안패치, 신규 기능을 받으세요.
백업: ServBay는 파일, DB, SSL 인증서, 설정 등 사이트의 수동/자동 백업을 지원합니다. 주요 변경 전이나 주기적으로 Joomla 사이트와 DB 백업을 습관적으로 해두세요. 해당 옵션은 ServBay 앱 내 백업 설정 메뉴에서 찾을 수 있습니다.

FAQ (자주 묻는 질문)

Q: 로컬 도메인 접속 시 “사이트에 연결할 수 없습니다” 혹은 404 오류가 나와요.A: 아래를 확인하세요.
1. ServBay가 정상 실행 중인지 체크
2. ServBay ‘사이트’ 목록에서 Joomla용 사이트가 활성화돼 있는지 확인
3. ‘사이트 루트’ 설정이 /Applications/ServBay/www/servbay-joomla-app으로 정확한지 확인
4. 도메인(servbay-joomla.local)과 ServBay에서 추가한 도메인이 일치해야 함
Q: Joomla 설치 중 데이터베이스 연결 오류가 발생해요.A: 대개 입력한 DB 정보가 잘못됐을 때 발생합니다. 아래 내용을 재확인하세요.
1. 설치 마법사에서 DB 호스트명이 localhost로 입력됐는지
2. DB 사용자명(servbay_joomla_user)과 비밀번호(password123)가 phpMyAdmin에서 만든 것과 일치하는지
3. 데이터베이스명(servbay_joomla_user)이 정확한지
4. ServBay 내 MySQL(MariaDB) 서비스가 실행 중인지
Q: ServBay의 MySQL root 비밀번호를 잊었습니다.A: ServBay에서 root 비밀번호 재설정 기능을 제공합니다. ServBay 앱 내 데이터베이스 관리 메뉴에서 안전하게 MySQL/MariaDB 루트 비밀번호를 초기화할 수 있습니다.
Q: 설치 후 사이트 접속 시 에러가 뜨거나 빈 화면만 나와요.A: 반드시 installation 폴더가 삭제됐는지 확인하고, Joomla의 에러 로그(설정 시) 또는 ServBay에서 제공하는 PHP 에러 로그(error_reporting 및 display_errors 설정 가능)를 확인하여 상세 원인을 파악하세요. 또한, PHP 버전이 Joomla 요구사항과 일치하는지 점검해 주세요.

마무리

ServBay를 이용하면 macOS에서 Joomla CMS 설치 및 설정을 쉽고 빠르게 할 수 있습니다. ServBay는 웹서버, 데이터베이스, PHP까지 사전 구성된 로컬 개발환경을 제공해, Joomla의 설치와 관리 과정을 크게 단순화합니다. 본 가이드의 단계를 따라가면 손쉽게 로컬 Joomla 개발환경을 구축하고 웹사이트 개발을 곧바로 시작할 수 있습니다. ServBay와 Joomla의 최신 버전을 항상 유지하고, 보안 모범 사례를 반드시 지키세요.

macOS의 ServBay 환경에서 Joomla CMS 설치 및 설정하기 ​

개요 ​

Joomla란 무엇인가요? ​

활용 사례 ​

사전 준비 사항 ​

Joomla 설치 절차 ​

1단계: Joomla 다운로드 ​

2단계: Joomla 압축 풀기 ​

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

4단계: 웹서버 설정(사이트 추가) ​

5단계: Joomla 설치 마법사 실행 ​

6단계: Joomla 관리자 백엔드 탐색 ​

Joomla로 웹사이트 구축하기 (간단 소개) ​

주의 사항 ​

FAQ (자주 묻는 질문) ​

마무리 ​