Gnuboard7/INSTALL.md

그누보드7 설치 가이드

그누보드7(G7)을 설치하는 방법을 안내합니다.

---

시스템 요구사항

항목	요구사항
PHP	8.2 이상 (필수 확장 30개 포함)
데이터베이스	MySQL 8.0+ 또는 MariaDB 10.3+ (utf8mb4)
Composer	2.x
Redis	6.0+ (프로덕션 권장, 선택)

상세 요구사항은 docs/requirements.md를 참조하세요.

---

방법 1: 웹 서버에서 바로 구동

Apache, Nginx 등 웹 서버가 이미 구동 중인 환경에서 설치합니다.

1단계: 소스 코드 다운로드

웹 서버의 루트 디렉토리(또는 원하는 위치)에서 실행합니다.

git clone https://github.com/gnuboard/g7.git

2단계: 웹 서버 설정

웹 서버의 DocumentRoot(또는 Virtual Host)를 g7/public 디렉토리로 설정합니다.

Apache 예시 (Virtual Host):

<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/g7/public

    <Directory /var/www/g7/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Nginx 예시:

server {
    listen 80;
    server_name example.com;
    root /var/www/g7/public;

    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

3단계: 설치 마법사 실행

브라우저에서 접속합니다.

http://도메인/install

설치 마법사의 안내에 따라 DB 정보 입력 및 관리자 계정을 생성합니다.

---

방법 2: 로컬 개발 서버 (PHP 내장 서버)

로컬 환경에서 개발/테스트 목적으로 빠르게 구동합니다.

1단계: 소스 코드 다운로드

git clone https://github.com/gnuboard/g7.git

2단계: 프로젝트 디렉토리로 이동

cd g7

3단계: Composer 의존성 설치

composer install

4단계: 환경 설정 파일 생성

cp .env.example .env

5단계: 개발 서버 실행

php artisan serve

6단계: 설치 마법사 실행

브라우저에서 접속합니다.

http://localhost:8000/install

설치 마법사의 안내에 따라 DB 정보 입력 및 관리자 계정을 생성합니다.

---

방법 3: ZIP 파일 다운로드

Git이 설치되지 않은 환경에서 설치합니다.

1단계: GitHub 접속

브라우저에서 아래 주소로 접속합니다.

https://github.com/gnuboard/g7

2단계: 릴리스 다운로드

1. 페이지 우측의 Releases 섹션을 클릭합니다.
2. 최신 릴리스를 선택합니다.
3. 하단의 Source code (zip) 을 다운로드합니다.

3단계: 압축 해제

다운로드한 ZIP 파일을 원하는 위치에 압축 해제합니다.

4단계: Composer 의존성 설치

터미널에서 압축 해제된 디렉토리로 이동한 후 실행합니다.

cd g7-버전명
composer install

5단계: 환경 설정 파일 생성

cp .env.example .env

6단계: 설치 진행

환경에 따라 선택합니다.

웹 서버가 있는 경우:

• DocumentRoot를 public 디렉토리로 설정한 후 브라우저에서 http://도메인/install 접속

로컬에서 구동하는 경우:

php artisan serve

브라우저에서 http://localhost:8000/install 접속

설치 마법사의 안내에 따라 DB 정보 입력 및 관리자 계정을 생성합니다.

---

설치 후 확인

설치가 완료되면 아래 페이지에 접근할 수 있습니다.

페이지	URL	비고
관리자 페이지	http://도메인/admin
사용자 페이지	http://도메인/	사용자 템플릿 설치 필수

사용자 페이지는 사용자 템플릿이 설치되어 있어야 접근할 수 있습니다. 인스톨러에서 사용자 템플릿을 함께 설치하거나, 관리자 페이지에서 템플릿을 먼저 설치해 주세요.

---

프로덕션 환경 추가 설정

프로덕션 환경에서는 아래 항목을 추가로 설정하는 것을 권장합니다.

HTTPS 설정

프로덕션 환경에서는 HTTPS를 사용해야 합니다. .env 파일에서 APP_URL을 https://로 설정하세요.

데몬 프로세스

상시 실행이 필요한 프로세스입니다. Supervisor 등을 사용하여 관리합니다.

프로세스	명령어	용도
큐 워커	php artisan queue:work	비동기 작업 처리
WebSocket	php artisan reverb:start	실시간 알림

스케줄러

cron에 아래 항목을 등록합니다.

* * * * * cd /path/to/g7 && php artisan schedule:run >> /dev/null 2>&1

상세 내용은 docs/requirements.md를 참조하세요.