PKP-OJS docker install

使用 docker-compose 安裝 PKP-OJS 系統

本文參考自 PKP-OJS 官方github文件

• 需求
• 安裝
• 設定
• 使用

需求

• docker
• docker-compose
• git

先把上面三個東西裝好，再來就可以開始安裝 PKP-OJS 了。

安裝

首先，先把 PKP-OJS 的 docker-compose.yml 檔案和.env.TEMPLATE 檔案下載下來。

git clone https://github.com/pkp/docker-ojs.git
mv docker-ojs journalName && cd journalName
#這裡的 journalName 是你的期刊名稱，可以自己取
mv .env.TEMPLATE .env
vim .env

env 設定

.env 裡面有幾個設定要注意一下：

• OJS_VERSION : 設定 OJS 的版本，目前最新的是 3.4.0-3 (2023/11/08)
• HTTP_PORT : 設定 OJS 的 port，預設是 8081，記得在server上開啟這個port
• HTTPS_PORT : 設定 OJS 的 port，預設是 8481，記得在server上開啟這個port
• DB_HOST : 設定資料庫的位置，預設是 db，這個是 docker-compose.yml 裡面的 service 名稱，如果你改了 docker-compose.yml 裡面的 service 名稱，這裡也要改

# Set your journal Tag:
COMPOSE_PROJECT_NAME=journal
PROJECT_DOMAIN=journal.localhost
SERVERNAME=$PROJECT_DOMAIN

OJS_IMAGE=ojs
OJS_VERSION=3_4_0-3

# IMPORTANT: Set a non used port.
HTTP_PORT=8081
HTTPS_PORT=8481

# Remember this to fill your installation form in a clean installatio
# MYSQL_VERSION=10.3
MYSQL_ROOT_PASSWORD=root

# OJS variables
OJS_CLI_INSTALL=0
OJS_DB_HOST=db
OJS_DB_DRIVER=mysqli
OJS_DB_USER=ojs
OJS_DB_PASSWORD=root
OJS_DB_NAME=ojs

---

安裝-續

source .env && wget "https://github.com/pkp/ojs/raw/${OJS_VERSION}/config.TEMPLATE.inc.php" -O ./volumes/config/ojs.config.inc.php
# 同時會在同一層資料夾掛載一個 volumes 資料夾，這是要給 docker-compose.yml 使用的
docker-compose up -d
# 然後你就會看到跑起兩個服務，一個是 ojs，一個是 db

設定

接下來，有一點小麻煩的是，要先進去 my_app_journal 的 container 裡面，把資料夾的權限都改為apache，不然會出現一些權限問題。

好像是用root進行 docker-compose up -d 之後，會把資料夾的權限改成root，所以要改回來。

docker exec -it my_app_journal sh
# 這裡的 my_app_journal 是 docker-compose.yml 裡面的 service 名稱，如果你改了 docker-compose.yml 裡面的 service 名稱，這裡也要改
# 進去會是 /var/www/html
chown apache:apache config.inc.php
chown apache:apache public/
#因為裡面是空的，所以不用 -R
chown apache:apache ../files/

然後開啟瀏覽器，輸入 http://localhost:8081，就會看到安裝畫面了。

如果是在server上安裝，就輸入 http://yourdomain:8081，就會看到安裝畫面了。

這邊要注意幾點:

• Database Host : 輸入 db (這是在docker-compose.yml裡面設定的)
• Database Username : 輸入 ojs
• Database Password : 輸入 root (這是在.env裡面設定的)
• langugage : 選擇 English (United States) (中文的話，會有一些問題)

然後按下 Install Open Journal Systems，就會開始安裝了。

安裝完成會導引到登入畫面，帳號密碼是剛剛設定的。

使用

安裝完成之後，就可以開始使用了。

• 管理頁面:

|| 這就是我說選中文會有的問題 ||

剩下可以參考 PKP-OJS 官方文件

---