the tree/설치 방법_{(r13 편집)}

[오류!] 편집 권한이 부족합니다. 로그인된 사용자 OR geoip:KR(이)여야 합니다. 해당 문서의 ACL 탭을 확인하시기 바랍니다.

[[분류:the tree]][include(틀:상위 문서, 문서=the tree)]
[목차]

== 시작하기 전 ==
=== 주의 사항 ===
 * the tree는 기존 상용 위키 엔진과 다르게 설치 방법이 많이 복잡한 편이다.
 * 그렇기 때문에 많은 사람들이 해당 엔진을 보다 쉽게 접근할 수 있게 가이드라인을 작성하는 문서가 이 문서이다.
 * 설치법이라는 것은 운영체제에 따라 많이 다를 수 있고, 프로그램 버전에 따라 달라질 수 있기 때문에 '''중간에 막힌다고 개발자나 타 위키 운영자에게 무작정 문의하지 말고 __일단 찾아보고__ help할 것'''.

=== 환경 ===
 * the tree는 서버 자원을 꽤 먹는 프로그램이다. 그렇기 때문에 권장 사양은 다음과 같다.
  * 램 4GB 이상일 것.
   * 검색 서버와 DB가 idle 상태[* 가만히 있을 때를 말함.] 기준 각각 500MB 언저리임. 당연히 위키 엔진이나 운영 체제까지 돌리려면 아무리 못해도 2GB는 넘어야 한다.
  * CPU 성능은 좋으면 좋을 수록 좋음.
   * DB에서 문서를 불러오는 속도, 검색 성능에 영향을 미침.
 * 본 문서에서 작성하는 설치 방법은 다음 환경과 같다.
  * Ubuntu 24.04.1 LTS
  * x86

== 설치 방법 ==
 * 시작하기 전에 apt 업데이트
{{{#!syntax sh
sudo apt update
sudo apt upgrade -y
}}}

=== node.js ===
 * nvm 설치.
 * [[https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating]]

 * nvm으로 20 버전 설치.
{{{#!syntax sh
nvm install 20
}}}
 * node.js 버전 관리 n도 있으니 참고. [[https://www.npmjs.com/package/n| ]]

 * 위키 엔진 재시작 기능을 사용하기 위한 pm2 설치
{{{#!syntax sh
npm install pm2 -g
}}}

=== MongoDB ===
 * 위키 엔진의 DB 설치
 * apt는 업데이트가 느리기 때문에 apt로 설치하는 것은 추천하지 않음.
 * MongoDB 메뉴얼은 한국어로 친절히 작성되어 있고, 명령어가 바뀔 수도 있기 때문에 공식 문서를 참고할 것.
  * [[https://www.mongodb.com/ko-kr/docs/manual/tutorial/install-mongodb-on-ubuntu/|Ubuntu 기준]]
  * [[https://www.mongodb.com/ko-kr/docs/manual/installation/|Ubuntu가 아닐 경우]]

  * 설치하였다면 계속하기 - [[https://www.mongodb.com/products/tools/compass|GUI를 원한다면 여기로]]
{{{#!syntax sh
sudo systemctl status mongod
# ^ MongoDB 실행 중인지 확인
mongosh
# ^ MongoDB 접속
}}}

 * DB 생성하고 DB에 접속할 user 만들기
> use test123 //test123 DB 생성 및 접속
> db.createUser({ user: "test01", pwd: "mypassword", roles: [ "readWrite" ]})  //test01 계정으로 mypassword 비밀번호로 readWrite 권한으로 계정 생성
> db.getUsers(); //생성된 User 확인

 * 만약 계정 생성이 되지 않는다면,
> vi /etc/mongod.conf //MongoDB 설정 파일 vi로 열기
> security:                             //주석 제거후
>  authorization: enabled   //추가

 * 그래도 DB 접근 불가 오류가 발생한다면,
> mongosh //MongoDB 접속
> use admin //admin DB 접속
> db.createUser({ user: "test01", pwd: "mypassword", roles: [ "readWrite" ]})  //test01 계정으로 mypassword 비밀번호로 readWrite 권한으로 계정 생성
=== Meilisearch ===
 * [[https://www.meilisearch.com/docs/learn/self_hosted/getting_started_with_self_hosted_meilisearch|설치하기]]
 * [[https://www.meilisearch.com/docs/guides/running_production#4-2-enable-and-start-service|systemctl에 추가해서 실행 편하게 하기]]

=== 엔진 설치 ===
{{{#!syntax sh
git clone https://github.com/wjdgustn/thetree --recursive
# ^ 엔진 git으로 불러오기
npm i
# ^ 라이브러리 다운로드하기
}}}

== 마지막 ==
 * 초기 설정 및 첫 실행은 다음 문서를 참고하자.
 * [[the tree/위키 구축]]

다올위키
운영 문서

규정

규정 | 면책조항 | 개인정보 처리방침 | 이메일 무단 수집거부

도움말

소개 | 기능 | 문법 | 토론

기능

위키 엔진 | 위키 스킨 | 통계 | 연습장 (토론 · ACL)

운영

관리자 _(/선출) | 운영 보고서 | 투명성 보고서 | 다중 계정 검사 보고서

분류

분류 | 틀 | 파일 | 템플릿 | 보존문서

the tree/설치 방법(r13 편집)

the tree/설치 방법_{(r13 편집)}