投稿者: manualmaton Page 7 of 274

概要

Growi v7.3.0のインストールメモです。

MongoDBの関係もあり、インストールするCPUを選びます。

備考

• v7系は利用するMongoDBの関係上、CPUを選びます。(Celeron系や古いアーキテクチャでは動きません）
• v7.3.0より、Elasticsearchのバージョンは従来のv8ではなくv9を必要とします。
  • Elasticsearchを用いる方は注意ください。

環境

• Ubuntu 24.04
• Apache 2.4

の基本的な設定が済んだという状況です。

前提

• 名前解決できるドメインが用意されている。
• そのドメインに応じた証明書が用意されている。

さっくりとはならない手順

1. 必要なパッケージをインストールします。
2. nvmをインストールします。
3. nvm経由でnode,npm,pnpmをインストールします。
4. Redis-serverをインストールします。
5. Javaをインストールします。
6. ElasticSearch 9をインストールします。
   • ElasticSearchの設定変更を行います。
   • ElasticSearchのプラグインをインストールします。
   • ElasticSearchの設定変更を反映します。
7. MongoDBをインストールします。
   • MongoDBのデータ格納先を変更します。(オプション)
   • MongoDBの設定変更を反映します。(オプション)
8. Growiのインストールを行います。
   • pnpmを用いてインストールします。
   • アプリのビルドを行います。
   • 自動起動のスクリプトを作成します。
9. Apacheのリバースプロキシの設定を行います。
10. ブラウザで初期インストールを行います。

手順

筆者の好みでaptitudeを用いています。適宜、aptに読み替えてください。

必要なパッケージのインストールを行います。

• git, buildツールなど

sudo aptitude install build-essential git git-lfs apt-transport-https

v7.1系で`git-lfsを入れないとgit-cloneでビルドが行えなかったので、その名残です。

Node.js環境の構築（nvm, npm, pnpm）

Growiの実行にはNode.jsが必要です。ここでは、バージョン管理を容易にするためnvm（Node Version Manager）を使ってインストールします。

メンテナンスユーザーでnvmをインストール

※rootではなく、作成したメンテナンスユーザーで実行します。

• メンテナンスユーザーでログインしていることを確認

whoami

• nvmインストールスクリプトを実行

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

このスクリプトは、~/.bashrcに必要な設定を自動で追記してくれます。

nvm環境を有効化

設定を現在のセッションに反映させるため、以下のコマンドを実行するか、一度ログアウトして再ログインしてください。

source ~/.bashrc

nvm --versionでバージョンが表示されれば成功です。

nvm経由でNode.jsと各種パッケージをインストール

Growiが必要とするバージョンのNode.jsと、npm, pnpmをインストールします。

• Node.js v20.19.2 をインストール

nvm install v20.19.2

• 使用するバージョンとして設定

nvm use v20.19.2

nvm alias default v20.19.2

• npmをv11.4.0にアップデート

npm install -g npm@11.4.0

• pnpmをインストール

npm install -g pnpm

rootユーザーにもnvm環境を適用（systemd連携のため）

Growiをサービスとして自動起動させるgrowi-start.shスクリプトは、root権限で実行されるsystemdから呼び出されます。そのため、rootユーザーもnvmの場所を知っている必要があります。

以下のコマンドで、メンテナンスユーザー用にインストールしたnvmへのシンボリックリンクを、rootのホームディレクトリに作成します。

sudo ln -sf /home/【maintenance_user】/.nvm /root/.nvm

【】内は自分のLinuxアカウント(メンテナンスユーザー名)に置き換えてください

これにより、rootで実行されるスクリプトも、メンテナンスユーザーと同じNode.js環境を参照できるようになります。

redis-serverをインストールします。

• インストール

sudo  aptitude install redis-server

• 起動確認

systemctl status redis-server

active(running)を確認します。

• 自動起動有効化

sudo systemctl enable redis-server

Javaをインストールします。

• インストール

sudo aptitude install openjdk-17-jdk

Elasticsearchをインストールします。

※v7.3.0よりElasticsearchのv9を用いるようになっています。

• gpg追加

sudo wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg

• レポジトリ追加

sudo echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/9.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-9.x.list

• パッケージのアップグレード

sudo aptitude update

• ElasticSearchインストール

sudo aptitude install elasticsearch

※この後、デフォルトパスワードが表示されますが、控えておく程度にしましょう。

JVM設定変更

• バックアップディレクトリ作成

sudo mkdir /etc/elasticsearch/old

※任意のバックアップディレクトリを指定します。

• 設定ファイルバックアップ

sudo cp -pi /etc/elasticsearch/jvm.options /etc/elasticsearch/old/jvm.options.$(date +%Y%m%d)

• 設定ファイル書き換え

echo -e "-Xms256m\n-Xmx256m" | sudo tee -a /etc/elasticsearch/jvm.options

• 書き換え確認

sudo diff -u /etc/elasticsearch/old/jvm.options.$(date +%Y%m%d) /etc/elasticsearch/jvm.options

• 差分

+-Xms256m
+-Xmx256m

ElasticSearchの設定変更

※この作業も管理者権限で実行します。

• root昇格

sudo su -

• 設定ファイルバックアップ

cp -pi /etc/elasticsearch/elasticsearch.yml /path/to/backup/elasticsearch.yml.$(date +%Y%m%d)

任意のバックアップディレクトリを指定します。

• ファイル書き換え

sed -i -e 's/xpack.security.enabled: true/xpack.security.enabled: false/' \
       -e '/xpack.security.http.ssl:/{n; s/  enabled: true/  enabled: false/}' \
       -e '/xpack.security.transport.ssl:/{n; s/  enabled: true/  enabled: false/}' /etc/elasticsearch/elasticsearch.yml

• 差分確認

diff -u /path/to/backup/elasticsearch.yml.$(date +%Y%m%d) /etc/elasticsearch/elasticsearch.yml

• 差分

 # Enable security features
-xpack.security.enabled: true
+xpack.security.enabled: false

 xpack.security.enrollment.enabled: true

 # Enable encryption for HTTP API client connections, such as Kibana, Logstash, and Agents
 xpack.security.http.ssl:
-  enabled: true
+  enabled: false
   keystore.path: certs/http.p12

 # Enable encryption and mutual authentication between cluster nodes
 xpack.security.transport.ssl:
-  enabled: true
+  enabled: false

• rootから抜ける

exit

ElasticSearchのプラグインを追加

• analysis-kuromoji インストール

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-kuromoji

• analysis-icu インストール

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-icu

自動起動設定反映

• 起動

sudo systemctl start elasticsearch

• 起動確認

systemctl status elasticsearch

active(running)を確認します。

• 自動起動有効化

sudo systemctl enable elasticsearch

MongoDBインストール

レポジトリ追加

• 必要パッケージインストール

sudo aptitude install gnupg

• gpg追加

curl -fsSL https://www.mongodb.org/static/pgp/server-6.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \
   --dearmor

• レポジトリ追加

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

MongoDBインストール

• パッケージのアップグレード

sudo aptitude update

• MongoDBインストール

sudo aptitude install mongodb-org

保存先変更（オプション）

MongoDBの格納先を、冗長化構成されているパーティションにするため対応しました。

本設定の要注意点

MongoDBは、その性質上、頻繁にファイルの書き換えを行います。そのため、ブロックストレージのような「データ削除ポリシー」が明記されているネットワークストレージに、保存パーティションを指定してはいけません。(筆者はそれで痛い目に遭いました)

本設定が必要な場合は、同じサーバ上の、SSDで行いましょう。

• 格納ディレクトリ作成

sudo mkdir /home/mongodb

保存先を変えたいところにします

• 所有者変更

sudo chown -R mongodb:mongodb /home/mongodb

• 所有者変更確認

ls -ld /home/mongodb

• 設定ファイルのバックアップ取得

sudo cp -pi /etc/mongod.conf /path/to/backup/mongod.conf.$(date +%Y%m%d)

任意のバックアップディレクトリを指定します。

• バックアップ確認

sudo diff -u /etc/mongod.conf /path/to/backup/mongod.conf.$(date +%Y%m%d)

バックアップが保存されたか、差分がないことで確認します。

• ファイル書き換え

sudo sed -i 's/dbPath: \/var\/lib\/mongodb/dbPath: \/home\/mongodb/' /etc/mongod.conf

• 差分確認

sudo diff -u /path/to/backup/mongod.conf.$(date +%Y%m%d) /etc/mongod.conf

• 差分

-  dbPath: /var/lib/mongodb
+  dbPath: /home/mongodb

自動起動有効

• mongodサービス起動

sudo systemctl start mongod

• サービス起動確認

systemctl status mongod

active (running)を確認します

• 自動起動有効化

sudo systemctl enable mongod

Growiインストール

• git clone

sudo git clone https://github.com/growilabs/growi /home/www-data/growi

※任意のディレクトリを指定します。

• ディレクトリ移動

cd /home/www-data/growi && pwd

先ほどcloneしたディレクトリです。

• チェックアウト

sudo git checkout -b v7.3.0 refs/tags/v7.3.0

2025/09/17時点での最新リリースです

• pnpmによるインストール

sudo pnpm install

CPUのスペックによっては相当な時間がかかります。

• ビルド

sudo npm run app:build

必要であればlfs pull

• lfs pull

sudo git lfs pull

→ v6.1で必要なコマンドでした。v7でビルドできない場合に試してください。

やはり時間がかかります。

自動起動スクリプトの作成

• systemd作成

cat <<- __EOF__ | sudo tee -a /etc/systemd/system/growi.service
[Unit]
Description = growi
After=network-online.target mongod.service
After=network.target elasticsearch.service
ConditionPathExists=【/home/www-data/growi】

[Service]
ExecStart=【/home/www-data/growi/】growi-start.sh
Restart=no
Type=simple

[Install]
WantedBy=multi-user.target
__EOF__

※【】内を、git cloneしたディレクトリにします。

• Growiインストールディレクトリに作成
• 教義・信仰に沿ったエディタで作成します。
• ファイル名:growi-start.sh
• growiを配置したディレクトリ内に作成します。

#!/bin/bash

# NVM environmentをロード (NVM_DIRを直接指定)
export NVM_DIR="/root/.nvm" # $HOMEの代わりに直接パスを指定
if [ -s "$NVM_DIR/nvm.sh" ]; then
  \. "$NVM_DIR/nvm.sh"  # nvmをロード
  # 次の行でスクリプト実行時のnodeとnpmのバージョンをログに出力
  echo "NVM for GROWI startup script loaded. Using Node version: $(node -v), npm version: $(npm -v)" > /tmp/growi_nvm_load.log
else
  # NVMが見つからない場合もログに出力
  echo "NVM_DIR ($NVM_DIR) not found or nvm.sh not found for GROWI startup script." > /tmp/growi_nvm_load.log
fi

cd 【/home/www-data/growi】
NODE_ENV=production \
AUDIT_LOG_ENABLED=true \
FORCE_WIKI_MODE=private \
MONGO_URI=mongodb://localhost:27017/growi \
ELASTICSEARCH_URI=http://localhost:9200/growi \
REDIS_URI=redis://localhost:6379 \
PASSWORD_SEED=[任意の文字列] \
npm run app:server

[任意の文字列]は推測されないような英数字+記号を指定します。

• 権限変更

sudo chmod +x /home/www-data/growi/growi-start.sh

• systemd設定反映

sudo systemctl daemon-reload

• growi有効化

sudo systemctl start growi.service

• growi有効化確認

systemctl status growi.service

active(running)を確認

• 自動起動有効化

sudo systemctl enable growi.service

Apacheによるリバースプロキシの設定

• モジュールインストール

sudo a2enmod proxy_http proxy_wstunnel rewrite headers

• apache再起動

sudo systemctl restart apache2.service

• ログ保存ディレクトリ作成

sudo mkdir /var/log/growi/

• 所有者変更

sudo chown -R www-data:www-data /var/log/growi

• 設定ファイル作成

cat <<- __EOF__ | sudo tee -a /etc/apache2/sites-available/growi.conf
<VirtualHost _default_:80>
    ServerName 【hoge.example.com】
    # ドメイン名を指定します
    RewriteEngine On
        RewriteCond %{HTTPS} off
        RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
# HTTPアクセスを強制的にHTTPSにリダイレクトします
</VirtualHost>

<VirtualHost _default_:443>
    ServerName 【hoge.example.com】
    # ドメイン名を指定します
    CustomLog /var/log/growi/growi_access.log combined 
    ErrorLog /var/log/growi/growi_error.log

#SSL設定
  SSLEngine on
    Protocols h2 http/1.1
SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
#TLS1.3に対応していないクライアントがアクセスする場合は以下を用います
#SSLProtocol -ALL +TLSv1.2 +TLSv1.3
SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384
SSLHonorCipherOrder     off
SSLSessionTickets       off

SSLCertificateFile 【/etc/certs/hoge.example.com.crt】
# SSL証明書を指定します
SSLCertificateKeyFile 【/etc/private/hoge.example.com.key】
# 秘密鍵を指定します

    # Header に Host: example.com を追加するため
    ProxyPreserveHost On
    # HTTPS利用時: Header に x-forwarded-proto: https を追加するため
    RequestHeader set x-forwarded-proto 'https'
    # Apache では static assets で 304 が返らないことがあるので ETag を無効化する
    <ifModule mod_headers.c>
            Header unset ETag
    </ifModule>

FileETag None 

<FilesMatch "\.(js|css|png|jpg|gif|svg|woff2?)$">
    Header set Cache-Control "public, max-age=31536000, immutable"
</FilesMatch>

# リバースプロキシー設定
RewriteEngine on
RewriteCond %{HTTP:Upgrade} websocket [NC]
RewriteRule /(.*) ws://localhost:3000/$1 [P,L]

ProxyPass        / http://localhost:3000/
ProxyPassReverse / http://localhost:3000/


#セキュリティヘッダー付与

    Header always set Strict-Transport-Security "max-age=63072000"
    Header always set X-Content-Type-Options "nosniff"
    Header always set X-Frame-Options "SAMEORIGIN"
    Header always set X-XSS-Protection "1; mode=block"
</VirtualHost>
__EOF__

【】内を自分の環境に変更してください。

• 設定反映

sudo a2ensite growi.conf

• コンフィグ確認

sudo apache2ctl configtest

Syntax OKを確認します。

• Apache2再起動

sudo systemctl restart apache2.service

Growiインストール確認

http://設定したドメイン でアクセスします。

初期サイトが表示されたらインストール完了です。

• 管理者メールアドレス
• 管理パスワード

等を設定してログインします。