라이믹스/설치

-
“	라이믹스는 PHP로 만들어져 있습니다. PHP는 국내외 대부분의 웹호스팅 서버에서 간단히 업로드하거나 압축을 풀기만 하면 별도의 서버 설정 없이 곧바로 사용이 가능하다는 장점이 있기 때문에, 전세계적으로 가장 많이 사용되는 CMS들은 대부분 PHP로 만들어져 있습니다.	”
	— 라이믹스 문서 중

1. 목표#

라이믹스를 설치해보자.

2. 필수사양#

아파치, PHP, MySQL과 같은 필수 설치요소는 LAMP 문서 등을 확인하자.

나머지 필요한 PHP 확장기능들과 퍼미션, php.ini 설정은 라이믹스/매뉴얼/설치 환경 문서를 확인하자.

요약하면 PHP 7.4 이상(8.2 이상 권장), MySQL 5.7 이상 또는 MariaDB 10.6 이상이 필요하다.

3. 설치 방법 선택#

공식 매뉴얼은 세 가지 방법을 안내한다.

방법	필요 조건	특징
정식 버전 압축 파일	FTP/SFTP만 있으면 됨	가장 무난하다. 대부분의 웹호스팅에서 사용 가능
Development Snapshot	FTP/SFTP만 있으면 됨	개발 중인 최신 코드. 정식 버전보다 빠르게 수정이 반영되지만 안정성은 낮다
git	SSH 접속과 git 사용 가능	이후 업데이트가 가장 편하다. 브랜치 선택도 가능

운영 중인 사이트라면 정식 버전을 쓰는 것이 좋다. Development Snapshot은 정식 버전에 아직 반영되지 않은 수정이 필요할 때 선택하되, 자주 업데이트할 각오를 해야 한다.

4. 브랜치#

git으로 설치할 경우 브랜치를 고를 수 있다. 2026년 8월 기준 공식 저장소의 브랜치는 다음과 같다.

브랜치	설명
master	기본 브랜치. 최신 정식 버전이 반영된다. 특별한 이유가 없다면 이것을 쓰자
v2.2	다음 버전인 2.2를 준비하는 브랜치. 개발 중이므로 운영 사이트에는 적합하지 않다
v2.1	2.1 버전대 유지보수 브랜치
v2.0	2.0 버전대 유지보수 브랜치
v1.9	1.9 버전대 유지보수 브랜치. 이미 지원이 종료되었다

※ 과거에는 develop과 next 브랜치를 사용했으나 현재는 존재하지 않는다. next는 2.0 준비용으로 쓰이던 브랜치로, 자세한 내용은 라이믹스/Next 라이믹스 문서를 참고하자.

※ 2.1.36을 기점으로 2.1은 긴급 보안 패치 외에는 업데이트되지 않으며, 개발의 초점이 2.2로 옮겨졌다.

5. 파일 다운로드#

5.1. 압축 파일로 다운로드#

공식 홈페이지에서 최신 정식 버전 또는 Development Snapshot을 내려받는다. 두 가지 방법이 있다.

• 로컬에서 압축을 풀고 전체 파일을 FTP/SFTP로 업로드
• 압축 파일을 업로드한 뒤 SSH로 접속해 서버에서 압축 해제

서버에서 압축을 푸는 편이 훨씬 빠르고 안전하다. FTP 프로그램은 파일이 수천 개에 달할 경우 일부를 누락하는 경우가 있으므로, 로컬에서 풀어 올렸다면 업로드가 온전히 끝났는지 확인해야 한다.

서버에서 압축을 풀면 rhymix 폴더가 생기므로 그 안의 내용을 상위 폴더로 옮겨야 한다. 이때 .htaccess 같은 숨김 파일이 빠지지 않도록 주의해야 한다.

5.2. git으로 다운로드(추천)#

대부분의 웹호스팅이나 VPS에서는 git을 지원하기 때문에 git을 사용하면 다운로드 및 업그레이드가 수월하다.

git으로 다운로드를 받으면, 브랜치도 선택이 가능하기 때문에 권장합니다. 브랜치 선택은 git clone -b 브랜치명 https://github.com/rhymix/rhymix 입니다.

5.2.1. 웹 호스팅#

SSH와 Git을 제공하는 호스팅에서는 웹 루트로 이동한 뒤 설치한다. 아래 예제의 /home/user/public_html은 실제 호스팅 경로로 바꾼다. 설치 대상 폴더가 숨김 파일까지 포함하여 비어 있을 때만 사용할 수 있다.

cd /home/user/public_html
git clone https://github.com/rhymix/rhymix.git .
mkdir -p files

마지막의 .은 새 하위 폴더를 만들지 않고 현재 폴더에 설치한다는 뜻이다. .git과 .htaccess도 함께 보존되므로 이후 Git 업데이트와 Apache의 짧은주소 기능을 사용할 수 있다. 기존 파일이 있는 폴더에는 이 명령으로 설치하지 말고, 별도 빈 폴더에 설치하거나 압축 파일 방식으로 진행한다.

5.2.2. 가상서버#

아래는 쓰기 권한이 있는 배포 계정으로 /var/www/html이라는 빈 설치 경로에 내려받는 예이다. 웹서버의 문서 루트도 이 경로와 일치해야 한다.

git clone https://github.com/rhymix/rhymix.git /var/www/html
cd /var/www/html
mkdir -p files

Git을 실행하는 배포 계정과 PHP를 실행하는 계정이 다를 수 있다. 설치 파일은 배포 계정이 관리하고, PHP 실행 계정에는 필요한 데이터 경로의 쓰기 권한을 부여한다.

6. files 폴더 권한#

files에는 첨부파일, 설정 파일, 캐시가 저장되므로 PHP 실행 계정이 읽고 쓸 수 있어야 한다. PHP 실행 계정과 FTP·배포 계정이 같으면 별도 퍼미션 조정이 필요하지 않을 수 있다. 호스팅 환경에 따라 공식 매뉴얼은 707 또는 777을 안내하지만, 모든 서버에서 이 값을 일괄 적용해야 한다는 뜻은 아니다.

단독 서버에서는 먼저 소유자·그룹과 PHP 실행 계정을 확인하여 필요한 권한을 부여한다. 707과 777은 모두 기타 사용자(other)에게 쓰기 권한을 허용하므로, 707이 다른 로컬 사용자의 쓰기를 막는 설정은 아니다. 특히 files/config에는 DB 접속 정보 등이 저장되므로 호스팅 업체의 계정 격리 방식과 권한 안내를 확인한다.

설치 경로에 쓰기 권한이 있으면 설치 과정에서 files가 자동으로 생성된다. 설치 후 첨부파일 업로드와 캐시 생성을 확인한다.

7. 웹 설치#

파일을 올린 뒤 브라우저로 설치 경로에 접속하면 설치 마법사가 시작된다. 과정은 네 단계이다.

1. 사용권 동의 — GPL 라이선스에 동의해야 다음으로 넘어간다. 언어는 화면 하단에서 언제든 바꿀 수 있다.
2. 설치 환경 확인 — PHP 버전과 필수 모듈, 퍼미션을 점검한다. mod_rewrite는 선택 사항이므로 없어도 설치는 진행된다.
3. DB 정보 입력 — 데이터베이스 종류와 접속 정보를 입력한다. 대개 localhost에 포트는 3306이다. 테이블 접두사는 rx 또는 xe를 권장한다.
4. 관리자 계정 생성 — 최고관리자 계정과 사용 가능한 이메일 주소를 입력한다. 표준 시간대는 국내 사이트라면 Asia/Seoul을 선택한다. SSL 사용 여부와 사이트 잠금도 이 단계에서 설정할 수 있다.

설치에는 10~30초 정도 걸린다. 완료되면 화면의 설정 아이콘을 통해 관리자 페이지로 들어갈 수 있다.

※ XE는 설치 언어 선택과 FTP 정보 입력을 포함해 여덟 단계를 거쳤다. 두 설치 과정의 차이는 라이믹스/XE와의 차이점 문서에 정리되어 있다.

8. 설치 후#

• 짧은주소 — Apache는 mod_rewrite와 .htaccess가 있어야 하고, nginx는 rewrite 설정을 직접 넣어야 한다.
• 크론 — 메일 발송이나 푸시 알림의 비동기 처리(Queue)를 쓰려면 크론 설정이 필요하다. 웹호스팅 환경이라면 웹크론을 따로 걸어야 한다. 불필요한 데이터를 지우는 정리 스크립트도 함께 등록해 두면 좋다. 라이믹스/매뉴얼/Crontab 설정 방법 문서를 참고하자.
• 캐시 — apcu가 설치되어 있으면 관리자 화면에서 캐시로 지정해 성능을 올릴 수 있다.
• 업데이트 — 라이믹스는 보안 패치가 잦으므로 설치 직후 최신 버전인지 확인하자. 방법은 라이믹스/매뉴얼/라이믹스 업데이트 문서를 참고하자.

9. 문제 해결#

• HTTP 500 오류 / BaseObject 오류 — HTTP 500의 원인은 다양하므로 PHP 오류 로그부터 확인한다. 오래된 서드파티 자료가 PHP 7.2부터 사용할 수 없는 Object 클래스를 쓰는 경우이다. 해결 방법은 설치 환경 문서를 참고하자.
• 첨부파일 업로드 실패 — 쓰기 권한·용량·PHP 업로드 제한·nginx 및 프록시 제한을 순서대로 확인한다. 라이믹스/매뉴얼/업로드 오류와 서버 진단 참고.
• 화면이 깨지거나 일부 파일이 없다는 오류 — 브라우저 네트워크에서 실패한 파일 URL과 상태를 확인한다. 파일 누락뿐 아니라 잘못된 설치 경로·문서 루트·캐시·권한도 확인한다.
• 짧은주소만 404 — Apache에서는 .htaccess·mod_rewrite와 해당 설정 허용 여부를, nginx에서는 rewrite 및 document root 설정을 확인한다.
• XE에서 넘어오는 경우라면 라이믹스/XE에서 넘어오기 문서를 참고하자. 새로 설치하는 것과 절차가 다르다.

10. 운영 점검#

설치가 끝나면 비로그인·일반 회원·관리자 화면, 새 글·댓글, 파일 업로드·다운로드, 메일·알림과 HTTPS 접속을 확인한다. 예약 작업은 등록 여부뿐 아니라 실제 발송·정리 결과까지 확인한다.

백업은 라이믹스/매뉴얼/백업과 복원, 수정 사항이 화면에 반영되지 않는 문제는 라이믹스/매뉴얼/캐시와 성능 점검을 참고한다.

11. 같이 보기#

• 라이믹스
• 라이믹스/매뉴얼 — 이 문서는 매뉴얼의 '라이믹스 설치' 항목을 겸한다
• 라이믹스/매뉴얼/설치 환경
• 라이믹스/매뉴얼/라이믹스 업데이트
• 라이믹스/XE에서 넘어오기
• 라이믹스/XE와의 차이점
• 라이믹스/버전