0.はじめに
リッチなUIのwikiツールとしてよさげなwebシステムにwiki.jsというものがあります。↓これが公式ドキュメントなのですが、これがそもそもwiki.jsで動作しているようで、つまりこんな感じのwikiが作れるようになります。
自分のナレッジツールとして今までいくつかを試して評価してきたのですが、今回wiki.jsを使ってみたかったのでAlmaLinux9.xにWiki.js 2.5.303をインストールし、まとめました。
構築にあたって参考にしたのはこちら↓です。
今の流行りっぽくdockerで構築する手順もあるので、手早くコンテナで済ませたい人や、マイクロサービス的に稼働させたい人にもおすすめかと思います。
各種ソフトとバージョンは次の通りです。
Software | Version |
---|---|
OS | AlmaLinux9.4 (Seafoam Ocelot) |
Wiji.js | 2.5.303 |
nodejs | v22.8.0 |
npm | 10.8.2 |
PostgreSQL | 16 |
1.インストール手順
0.ユーザ作成
useradd wikijs
passwd wikijs
usermod -aG wheel wikijs
exit
1. システムの更新とNode.jsのインストール
- ここからはwikijsユーザでログインし実行
sudo dnf update -y
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install nodejs -y
node -v # v22.8.0
npm -v # 10.8.2
2. PostgreSQLのインストールと設定
sudo dnf install https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm -y
sudo dnf install postgresql16 postgresql16-server postgresql16-contrib -y
sudo postgresql-16-setup initdb
sudo systemctl enable postgresql-16
sudo systemctl start postgresql-16
3. データベースとユーザーの作成
sudo -i -u postgres
psql
そのまま以下のコマンドをpsql内で実行
CREATE DATABASE wiki;
CREATE USER wikijs WITH PASSWORD 'wikijsrocks';
GRANT ALL PRIVILEGES ON DATABASE wiki TO wikijs;
# publicスキーマの所有者変更
\c wiki
ALTER SCHEMA public OWNER TO wikijs;
GRANT ALL PRIVILEGES ON SCHEMA public TO wikijs;
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO wikijs;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON TABLES TO wikijs;
# psqlを終了
\q
# ユーザをもとに戻す
exit
4. Wiki.jsのダウンロードとインストール
sudo mkdir /var/wiki
cd /var
sudo dnf install wget -y # wgetがインストールされていない場合
sudo wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
sudo dnf install tar -y # tarがインストールされていない場合
# 解凍して所有者を変更する
sudo tar xzf wiki-js.tar.gz -C /var/wiki
sudo chown -R wikijs.wikijs /var/wiki
cd /var/wiki
npm install --legacy-peer-deps
5. 設定ファイルのコピー
cp config.sample.yml config.yml
6. Systemdサービスの設定
sudo vi /etc/systemd/system/wikijs.service
以下の内容を追加
[Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
User=wikijs
Environment=NODE_ENV=production
WorkingDirectory=/var/wiki
[Install]
WantedBy=multi-user.target
7. Wiki.jsサービスの起動と有効化
sudo systemctl enable wikijs
sudo systemctl start wikijs
8.設定画面の起動
-
http://サーバのIP:3000
にアクセスします。ローカルホストの場合はhttp://localhost:3000
でもOK -
↓この画面が表示されればWiki.js 2.5.303のインストールは完了です。