Hermes
개요
설치
| 과정 | 설명 | 비고 |
|---|---|---|
| 준비 | sudo apt update
sudo apt install -y curl | |
| 설치 | 필요한 것들이 자동 설치되는데, 꽤 걸린다. | curl -fsSL https://openclaw.ai/install.sh | bash |
| 확인 | 버전 출력되면 성공.
이후 자동으로 설정 진행. |
openclaw --version |
지원 환경
지원되는 운영체제와 요구사항은 다음과 같습니다.
| 항목 | 요구 조건 |
|---|---|
| 운영체제 | 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
git clone https://github.com/example/hermes.git
cd hermes
- 또는 배포 파일
[source|https://example.com/hermes/releases]
2. 의존성 설치
PHP 의존 패키지를 설치합니다.
composer install
3. 데이터베이스 생성
운영 환경에서는 먼저 DB를 생성합니다.
- MariaDB 예시
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';
4. 웹 서버 설정
Apache 또는 Nginx에서 설치 경로를 웹root로 연결합니다.
- Apache: `DocumentRoot` 설정
- Nginx: `root` 설정과 `index.php` 처리
5. 초기화 실행
설치 스크립트 또는 웹 초기화 페이지를 실행합니다.
- 웹: `http://your-domain/install.php`
- CLI: `php bin/hermes install`
기본 설정
설치 후 `LocalSettings.php`(미디어위키) 또는 Hermes 전용 설정 파일에서 값을 조정합니다.
| 항목 | 권장값 | 설명 |
|---|---|---|
| 언어 | ko | 위키 언어 |
| 업로드 허용 | true | 파일 업로드 활성화 |
| 로그 레벨 | warning | 로그 출력 수준 |
| 캐시 | enabled | 캐시 활성화 |
기본 설정 예시:
$wgLanguageCode = 'ko';
$wgEnableUploads = true;
$wgLogLevel = 'warning';
확인 방법
설치가 성공했는지 확인합니다.
- Hermes 메인 페이지 접속
- `Hermes/변경이력` 페이지 존재 확인
- 관리자 패널에서 상태 확인
자주 나는 오류
업로드 불가
- 웹서버 `upload_max_filesize` 설정 확인
- PHP `memory_limit` 확인
데이터베이스 연결 오류
- DB 사용자 권한 재확인
- `host`, `port`, `charset` 설정 확인
웹서버 404 오류
- DocumentRoot 또는 `root` 경로 확인
- `index.php` 처리 규칙 확인