====== DokuWiki安裝程序(Docker) ======
===== Docker 安裝方式 =====
  * 安裝環境
    - [[tech/alpine_docker|Alpine 3 + Docker compose]]
    - [[tech/docker|Ubuntu 20.04 + Docker compose]]
===== 採用 linuxserver/dokuwiki 的 image =====
  * 參考網址 - https://github.com/linuxserver/docker-dokuwiki
  * 安裝方式
    - 編輯 docker-compose.yml <cli>
vi docker-compose.yml</cli><file>
version: '2'
services:
  dokuwiki:
    image: lscr.io/linuxserver/dokuwiki:latest
    container_name: dokuwiki
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Taipei    
    ports:
      - '80:80'
      - '443:443'
    restart: always
    volumes:
      - './dokuwiki_data:/config'
</file> 
      * wiki data 實際存放在 ./dokuwiki_data/dokuwiki 目錄內
      * cert 憑證檔存放位置在 ./dokuwiki_data/keys 目錄內
    - 啟動 docker compose <cli>
docker compose up -d
</cli>

<note tip>
**移轉原本 wiki data 簡易操作程序**
  - 將原本資料目錄內的 data lib conf 三個目錄打包成 tar
  - 將打包好的 data.tar lib.tar conf.tar 複製到 ./dokuwiki_data/dokuwiki/ 目錄
  - 關閉 dokuwiki 服務
  - 進入 ./dokuwiki_data/dokuwiki/
  - 將原本 data lib conf 三個目錄更名為 data.org lib.org conf.org
  - 解開 data.tar lib.tar conf.tar 打包檔成為 data lib conf 三個目錄
  - 改正 data lib conf 三個目錄權限
  - 重新啟動 dokuwiki 服務
  * ++看實際處理 linux 命令語法|<cli>
docker compose down
cd dokuwiki_data/dokuwiki/
mv conf conf.org
tar -xvf conf.tar
mv lib lib.org
tar -xvf lib.tar
mv data data.org
tar -xvf data.tar
chown -R 1000:1000 data
chown -R 1000:1000 lib
chown -R 1000:1000 conf
cd
docker compose up -d
</cli>++
  
</note>
 
  * 如果有安裝 [[http://www.dokuwiki.org/plugin:statistics|Statistics Plugin]] 需要 mysql 資料庫, 可參考 [[tech:dokuwiki:statistics]]
===== 採用 bitnami/dokuwiki 的 image =====
  * 安裝方式 <cli>
curl -sSL https://raw.githubusercontent.com/bitnami/containers/main/bitnami/dokuwiki/docker-compose.yml > docker-compose.yml
docker-compose up -d
</cli>
  * 預設帳號密碼 : user / bitnami1
  * 參考網址 - https://hub.docker.com/r/bitnami/dokuwiki

<note tip>
  * 如果要使用最新版以及每次開機可自動啟動, 需要在 docker-compose.yml 內**將 image 的 tag 改成 latest** 以及加上  **restart: always** Exp. <cli>
$ cat docker-compose.yml
# Copyright VMware, Inc.
# SPDX-License-Identifier: APACHE-2.0

version: '2'
services:
  dokuwiki:
    image: docker.io/bitnami/dokuwiki:latest
    restart: always
    ports:
      - '80:8080'
      - '443:8443'
    volumes:
      - 'dokuwiki_data:/bitnami/dokuwiki'
volumes:
  dokuwiki_data:
    driver: local
</cli>
  * wiki data 實際存放目錄 **/var/lib/docker/volumes/root_dokuwiki_data/_data** , 可以建立 wiki_data 當捷徑 <cli>
ln -s /var/lib/docker/volumes/root_dokuwiki_data/_data wiki_data
</cli>
  * 如果要設定使用自己的 SSL 憑證, 需要將憑證檔依照以下的方式掛入 Exp. 由 Let's Encrypt 取得憑證檔:fullchain.pem , 金鑰檔:privkey.pem
    - 將憑證檔與金鑰檔複製到憑證目錄 Exp. /root/certs <cli>
cp fullchain.pem /root/certs/server.crt
cp privkey.pem /root/certs/server.key
</cli>
    - 修改憑證目錄與檔案符合 docker 可存取的權限 Exp. 1001 <cli>
chown -R 1001 /root/certs
</cli>
    - 修改 docker-compose.yml 增加掛載憑證目錄 <cli>
:
    volumes:
      - 'dokuwiki_data:/bitnami/dokuwiki'
      - /root/certs:/certs
:
</cli>
    - 重新啟動 docker compose <cli>
docker compose up -d
</cli>
</note>

===== 延伸參考資料 =====
{{topic>dokuwiki}}


{{tag>dokuwiki 安裝}}