새로 설치하기

설치 화면 미리보기

썸네일을 누르면 설치 화면을 크게 볼 수 있습니다. 실제 설치 화면 소스로 만든 예시이며 계정·주소는 설명용 값입니다. 아래 순서대로 진행하되 접속 정보와 점검 결과는 본인의 호스팅 환경을 기준으로 확인하세요.

크게 보기

크게 보기

크게 보기

크게 보기

크게 보기

크게 보기

설치 전 준비

SQLite 설치는 지원하지 않습니다. 웹호스팅 관리 화면에서 DB와 전용 계정을 먼저 만들고 GNUCMS에 접속 정보를 입력합니다. GNUCMS가 호스팅 계정이나 DB 서버 자체를 만들어 주지는 않습니다.

어떤 파일을 받아야 하나요

GitHub Releases에 첨부된 gnucms-X.Y.Z.zip 완성 배포본을 받습니다. 실행에 필요한 vendor와 정적 파일이 포함됩니다. Source code (zip)와 main.zip은 개발용 소스로 vendor가 없으므로 그대로 설치할 수 없습니다.

파일 배치

gnucms/
  config/
  src/
  storage/
  templates/
  modules/
  plugins/
  vendor/
  www/         ← 웹 문서 루트
    .htaccess
    index.php
    install.php

1. 웹 문서 루트를 www 폴더로 지정합니다. 호스팅 계정의 www가 고정이면 배포본 www의 내용만 그 안에 올립니다.
2. config·src·storage·templates·modules·plugins·vendor는 웹 문서 루트보다 한 단계 위에 배치합니다.
3. 숨김 파일 .htaccess도 업로드합니다. Apache에서 mod_rewrite를 사용할 수 있어야 짧은 경로를 정상 처리합니다.
4. PHP 실행 계정에 config와 storage 쓰기 권한을 줍니다. 나머지 소스는 읽기 권한으로 운영합니다.

config나 storage 전체를 웹에서 직접 내려받을 수 있게 공개하지 않습니다. 특히 config/config.php와 백업 파일은 공개 경로에 두지 않습니다.

웹 설치 실행

1. 사이트를 열거나 /install.php로 접속합니다. 설정 파일이 없으면 설치 화면으로 이동합니다.
2. 서버 점검을 확인하고 필수 항목의 오류부터 해결합니다.
3. DB 접속 정보를 입력합니다. 별도의 테이블 접두어는 한 DB에 여러 사이트를 넣는 경우에만 지정합니다.
4. 사이트 이름·주소·발신 이메일과 첫 관리자 계정을 입력합니다.
5. 마지막 확인 화면에서 설치를 실행하고 완료 안내를 확인합니다.
6. 로그인해 관리 콘솔을 엽니다. install.php가 자동 삭제되지 않았다면 FTP에서 해당 파일을 삭제합니다.

설치 후 확인

• 홈과 /login, /admin에서 오류 없이 화면이 열리는지 확인합니다.
• 사이트 주소는 실제 HTTPS 도메인과 설치 폴더를 가리켜야 합니다. 다른 주소가 설정되면 메일·문자 링크도 잘못 만들어질 수 있습니다.
• DB 접두어는 설치 후 바꾸지 않습니다. 접두어 변경은 기존 테이블의 데이터 이전 작업이 필요합니다.
• 외부 메일·문자·카드 결제는 별도 계정과 설정을 연결한 뒤 사용합니다. 설치 완료만으로 자동 연결되지 않습니다.