Hermes 편집하기

== 개요 ==

=== 설치 ===
{| class="wikitable"
!과정
!설명
!비고
|-
|준비
|
|sudo apt update
sudo apt install -y curl
|-
|설치
|필요한 것들이 자동 설치되는데, 꽤 걸린다.
|<nowiki>curl -fsSL https://openclaw.ai/install.sh | bash</nowiki>
|-
|확인
|버전 출력되면 성공.
이후 자동으로 설정 진행.
|openclaw --version
|}



== 지원 환경 ==
지원되는 운영체제와 요구사항은 다음과 같습니다.

{| class="wikitable"
|+ 요구사항
|-
! 항목
! 요구 조건
|-
| 운영체제
| Linux (Ubuntu 20.04+), macOS 12+, Windows 10+
|-
| PHP
| 8.2 이상
|-
| 데이터베이스
| MariaDB 10.6+, MySQL 8+, PostgreSQL 13+, SQLite 3
|-
| 웹서버
| Apache 2.4+, Nginx + PHP-FPM
|-
| 메모리
| 2GB 이상 (권장 4GB)
|-
| 저장 공간
| 1GB 이상
|}

== 준비물 ==
설치 전에 다음을 준비합니다.

* 웹서버 접근 권한 또는 로컬 서버 환경
* 데이터베이스 생성 권한 (운영 환경)
* Hermes 설치 파일 또는 Git 소스

== 설치 절차 ==

=== 1. 설치 파일 얻기 ===
Git으로 소스를 가져오거나 공식 배포 파일을 다운로드합니다.

# Git
<source lang="bash">
git clone https://github.com/example/hermes.git
cd hermes
</source>

# 또는 배포 파일
[source|https://example.com/hermes/releases]

=== 2. 의존성 설치 ===
PHP 의존 패키지를 설치합니다.

<source lang="bash">
composer install
</source>

=== 3. 데이터베이스 생성 ===
운영 환경에서는 먼저 DB를 생성합니다.

# MariaDB 예시
<source lang="sql">
CREATE DATABASE hermes DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'hermes_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON hermes.* TO 'hermes_user'@'localhost';
</source>

=== 4. 웹 서버 설정 ===
Apache 또는 Nginx에서 설치 경로를 웹root로 연결합니다.

* Apache: `DocumentRoot` 설정
* Nginx: `root` 설정과 `index.php` 처리

=== 5. 초기화 실행 ===
설치 스크립트 또는 웹 초기화 페이지를 실행합니다.

* 웹: `http://your-domain/install.php`
* CLI: `php bin/hermes install`

== 기본 설정 ==
설치 후 `LocalSettings.php`(미디어위키) 또는 Hermes 전용 설정 파일에서 값을 조정합니다.

{| class="wikitable"
|+ 권장 설정 항목
|-
! 항목
! 권장값
! 설명
|-
| 언어
| ko
| 위키 언어
|-
| 업로드 허용
| true
| 파일 업로드 활성화
|-
| 로그 레벨
| warning
| 로그 출력 수준
|-
| 캐시
| enabled
| 캐시 활성화
|}

기본 설정 예시:

<source lang="php">
$wgLanguageCode = 'ko';
$wgEnableUploads = true;
$wgLogLevel = 'warning';
</source>

== 확인 방법 ==
설치가 성공했는지 확인합니다.

* Hermes 메인 페이지 접속
* `Hermes/변경이력` 페이지 존재 확인
* 관리자 패널에서 상태 확인

== 자주 나는 오류 ==

=== 업로드 불가 ===
* 웹서버 `upload_max_filesize` 설정 확인
* PHP `memory_limit` 확인

=== 데이터베이스 연결 오류 ===
* DB 사용자 권한 재확인
* `host`, `port`, `charset` 설정 확인

=== 웹서버 404 오류 ===
* DocumentRoot 또는 `root` 경로 확인
* `index.php` 처리 규칙 확인


[[분류:Hermes]]