그누보드5 SE 셸 설치 매뉴얼

SSH로 서버에 접속해 git으로 내려받아 설치하는 방법입니다. 셸(SSH) 접근이 가능한 VPS·클라우드·전용 호스팅 환경에 적합하며, 이후 git pull로 손쉽게 업데이트할 수 있습니다.

셸 접근이 없는 일반 웹호스팅이라면 FTP 설치 문서를 참고하세요.

1. 서버 접속

ssh 사용자명@서버주소

2. 소스 내려받기

웹 루트(예: /var/www 또는 ~/www)로 이동한 뒤 저장소를 클론합니다.

cd /var/www
git clone https://github.com/gnuboard/g5se.git
cd g5se

특정 버전을 설치하려면 태그를 체크아웃합니다.

git checkout v0.1.0

3. data 디렉터리 생성 및 권한

업로드·설정 파일이 저장되는 data 디렉터리를 만들고 권한을 707로 지정합니다.

mkdir -p data && chmod 707 data

4. 데이터베이스 생성

설치에 사용할 MySQL 데이터베이스를 만듭니다. (문자셋은 utf8mb4 권장)

mysql -u root -p -e "CREATE DATABASE g5se CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci"

필요하면 전용 DB 계정을 만들고 권한을 부여합니다.

mysql -u root -p -e "CREATE USER 'g5se'@'localhost' IDENTIFIED BY '비밀번호'; \
GRANT ALL PRIVILEGES ON g5se.* TO 'g5se'@'localhost'; FLUSH PRIVILEGES;"

5. 웹 서버 설정

웹 서버의 문서 루트(DocumentRoot)를 클론한 g5se 디렉터리로 지정하고, .htaccess(Apache)가 동작하도록 AllowOverride All을 설정합니다. (Nginx는 PHP-FPM + try_files 구성)

6. 설치 마법사 실행

브라우저에서 도메인의 설치 경로로 접속해 마법사를 진행합니다.

https://도메인/install/

라이선스 확인 → MySQL 정보(3·4단계에서 만든 DB·계정) → 최고관리자 정보를 입력하면 설치가 완료됩니다.

7. 마무리

설치가 끝나면 사용자 화면·게시판·관리자 로그인이 정상 동작하는지 확인합니다. 보안을 위해 설치 디렉터리 접근을 차단하는 것을 권장합니다.

셸로 설치했다면 업데이트는 git pull 한 줄로 끝납니다. 자세한 내용은 업데이트 문서를 참고하세요.