설치 가이드

설치 순서

서버 프로그램 설치와 소스 업로드(composer install 포함)를 마친 상태를 기준으로 설명합니다. 아래 예시의 /var/www/okcms(설치 경로), example.com(도메인), okcms(DB 이름)는 실제 환경에 맞게 바꿔 입력해 주세요.

1. 환경 설정 파일(.env) 작성
2. 데이터베이스 생성
3. 파일 저장 폴더 연결과 권한 설정
4. 스케줄러 등록
5. 관리자 계정 생성
6. 관리자 페이지 초기 설정

1. 환경 설정 파일(.env) 작성

예시 파일을 복사해 .env를 만들고 애플리케이션 키를 생성합니다.

cp .env.example .env
php artisan key:generate

.env 파일에서 아래 항목을 운영 환경에 맞게 수정합니다.

2. 데이터베이스 생성

MySQL에 데이터베이스와 접속 계정을 만듭니다.

sudo mysql
CREATE DATABASE okcms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'okcms'@'localhost' IDENTIFIED BY '비밀번호';
GRANT ALL PRIVILEGES ON okcms.* TO 'okcms'@'localhost';
FLUSH PRIVILEGES;
EXIT;

테이블을 만듭니다.

php artisan migrate --force

3. 파일 저장 폴더 연결과 권한 설정

관리자 화면에서 올린 이미지·첨부파일이 사이트에 보이도록 저장 폴더를 연결하고, 웹 서버가 쓸 수 있도록 권한을 줍니다.

php artisan storage:link
sudo chown -R www-data:www-data storage bootstrap/cache public/assets/media
sudo chmod -R 775 storage bootstrap/cache public/assets/media

설정을 바꾼 뒤에는 설정·화면 캐시를 새로 만들어 성능을 높입니다.

php artisan config:cache
php artisan view:cache

4. 스케줄러 등록

AI 작업 실행, 블로그 예약 공개, 방문자 통계 동기화 같은 예약 작업은 Laravel 스케줄러에 이미 등록되어 있습니다. 서버 관리자가 cron에 아래 한 줄을 직접 등록하면 1분마다 스케줄러가 실행되어 각 작업이 정해진 시간에 처리됩니다.

sudo crontab -u www-data -e

# 맨 아래에 한 줄 추가
* * * * * cd /var/www/okcms && php artisan schedule:run >> /dev/null 2>&1

5. 관리자 계정 생성

첫 관리자 계정은 서버에서 명령어로 만듭니다.

php artisan admin:create admin@example.com 관리자

두 번째 관리자부터는 관리자 > 시스템 관리 > 관리자 화면에서 추가할 수 있습니다.

6. 관리자 페이지 초기 설정

브라우저에서 https://example.com/admin으로 접속해 로그인한 뒤, 아래 항목을 차례로 설정합니다.