本手順書では、以下の2つのパッケージを使用して、Flow LiteとKrugle Biblioを導入する手順を説明します。

導入順序は必ず以下の順番で実施してください。

A → B

Krugle BiblioとFlow Liteは一つのGPUを搭載したホスト上に導入します。

以下の3つのパッケージが、あらかじめ導入対象サーバー上に配置されていることを確認してください。

https://downloads.krugle.org/.archaea/
　flow-lite-gpu-*.tar.gz
　biblio-*.tar.gz
　
　checkpoints.tgz [Option]

HTTPS通信用の証明書ファイルを準備してください。

例：自己証明書の場合

openssl req -newkey rsa:4096 -nodes -sha256 -keyout server.key -x509 -days 3650 -out server.crt

以降の手順では例として以下のファイル名を使用します。

server.crt
server.key

tar -xzf flow-lite-gpu-*.tar.gz
cd flow-lite-gpu

sudo ./install.sh

インストール中に表示されるプロンプトに従って、以下の内容を入力します。

• 出力言語
• マルチモーダルモデル名
• マルチモーダルモデル用のAPIキー

このステップは、デフォルトの日本語パーサーLinguastarに替えてIngestarを使用する場合にのみ必要ですので、通常はスキップしてください。

tar -xzf checkpoints.tgz -C /opt/flow-lite/

sudo systemctl start flow-lite

Flow Lite のみライセンス登録が必要です。

まず、フィンガープリントファイルを作成します。

cd /opt/flow-lite
sudo ./fingerprint.sh > fingerprint.txt

作成された fingerprint.txt をKrugle担当者へご送付ください。

ライセンスファイルarchaea.licを受領したら、以下の場所に保存します。

/opt/flow-lite/archaea.lic

注意：

• ライセンスファイルを受領するまで、以降のステップへの進行はお待ちください。

ライセンスファイル配置後、Flow Lite を再起動します。

sudo systemctl start flow-lite

tar -xzf biblio-*.tar.gz
cd biblio

sudo ./install.sh

Install system dependencies? (y/n): y

AI Response Language (English/Japanese/Chinese) [English]: Japanese

Multi-Modal LLM Model [gpt-5.2]: <your LLM model>
Multi-Modal LLM API Host[https://api.openai.com/v1]: <your API URL> 
Multi-Modal LLM API Key: <your API Key>   

Flow Lite Service Host [flow-lite]:  

LLM Model [gpt-5.2]: <your LLM model>
LLM API Host [https://api.openai.com/v1]: <your API URL> 
LLM API Key:  <your API Key>   


Embedding Model [text-embedding-3-large]: <your embedding model>
Embedding Dimension [3072]: <your embedding dimention>
Embedding API Key: 

インストール中求められる Flow Lite Service Host に対し、今回の「Flow Liteを同一ホスト上で動かす場合」にはデフォルトのままか、あるいはflow-liteと回答します。

Flow Lite が別のGPUサーバー上にある場合は、Flow Lite サーバーのIPアドレスを入力します。 例：192.168.0.1

インストール手順中で設定された内容について、導入完了後は随時環境変数定義ファイル/opt/biblio/.envで変更することができます。

Biblio Web UI 用のSSL証明書を配置します。

sudo cp server.crt server.key /opt/biblio/webui/ssl/

sudo systemctl start biblio

Biblio サービス起動後に、データベースマイグレーションを実行します。

sudo /opt/biblio/db-migrate.sh

注意：

• db-migrate.sh は、必ず Biblio 起動後に実行してください。

導入完了後、ブラウザから以下のURLにアクセスします。 <host> には、導入したサーバーのホスト名またはIPアドレスを指定してください。

https://<host>/

• デフォルトの管理ユーザ：：admin/123456
• ログイン後、実際に利用されるユーザごとにアカウントを作成してください

例：Biblio を再起動する場合

sudo systemctl restart biblio

例：Biblio の状態を確認する場合

sudo systemctl status biblio

一般的な操作は以下の形式で実行します。

sudo systemctl start <service-name>
sudo systemctl stop <service-name>
sudo systemctl restart <service-name>
sudo systemctl status <service-name>

例：

sudo systemctl restart flow-lite
sudo systemctl restart biblio

Dockerコンテナの稼働状況を確認します。

docker ps
docker stats

例：manufact-api コンテナのログを確認する場合

docker logs -f manufact-api

製品の設定ファイルを変更した場合は、対象サービスを再起動します。

例：ArcFact の設定を変更する場合

sudo nano /opt/arcfact/.env
sudo systemctl restart arcfact

各サービスの起動、停止、再起動には、原則として systemctl を使用してください。

sudo systemctl restart flow-lite

docker compose を直接使用して起動・停止することは推奨されません。

やむを得ず docker compose を手動で実行する場合は、必要な環境変数を読み込んだ上で実行してください。

例：ArcFact の compose 状態を確認する場合

cd /opt/biblio
sudo bash -c 'set -a; . ./compose.env; docker compose ps'

以下の4サービスは、サーバー再起動時に自動起動します。

flow-lite
biblio

以下を確認してください。

• Flow Lite が起動していること
• Flow Lite のライセンスファイル /opt/flow-lite/archaea.lic が配置されていること
• Biblio が起動していること
• Biblio のDBマイグレーションが完了していること
• https://<host>/biblio/ で Krugle Biblio にアクセスできること
• docker ps で関連コンテナが起動していること