자체 Wiki Server 구축 (Self-hosted Wiki server)

작성일: 2025년 2월 17일

 

 

Wiki 서버를 사내망에 자체적으로 구축할 때, 아래의 방법으로 설치 !!

 

Docker compose 파일을 작성

아래 예제와 같이 'docker-compose.yaml' 파일을 작성한다.

## Filename: docker-compose.yaml

services:

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: none
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data

  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "80:3000"

volumes:
  db-data:

 

 참고: 위 YAML 내용은 아래 온라인 문서에서 발췌했음.

https://docs.requarks.io/install/docker#using-docker-compose

 

 

Docker compose 명령으로 Wiki 서버를 설치

## 참고:  -d 옵션은 데몬 모드로 구동하기 위해서 추가했다.
$ docker compose up -d

## container 내부에서 출력되는 로그 내용을 보려면, `logs -f` 명령을 수행한다.
$ docker compose logs -f

 

 

 

Web browser로 접속하기

예를 들어, 아래와 같이 URL을 입력하여 Wiki 페이지에 접속한다.

 

http://10.1.1.3/

 

아래와 같은 초기 설정 화면이 보일 것이다.

빈칸에 적당한 값을 채우면, Wiki 서버 설정 끝.

그 이후부터는 Wiki 문서 작성하는 방법으로 내용을 채우면 된다.

 

Wiki.js 초기 설정 화면 (설치 화면)