Linuxにインストールする

SetFN SpaceBuilderをLinuxホストで直接実行する方法を案内します。以下の例はUbuntu系のディストリビューションを基準にしており、ほかのディストリビューションではパッケージ名やインストールコマンドが異なる場合があります。

始める前に

パッケージのインストールと自動起動の設定に使うsudo権限
サービスデータと、今後アップロードするファイルを保存できる十分なディスク容量
ほかのデバイスから接続する場合は、サーバーポートに対するファイアウォールのアクセス許可

SpaceBuilderの実行にsudo権限は必要ありません。一般ユーザーアカウントで実行してください。

一般的なLinux PCやサーバーだけでなく、NVIDIA DGX Spark、ASUS Ascent GX10、Dell Pro Max with GB10、HP ZGX Nano AI Station、Lenovo ThinkStation PGX、MSI EdgeXpertなどのGB10ベースの個人向けAIシステムも、Linuxホストとして利用できます。これらの機器は、ローカルAIモデルの実行やナレッジのインデックス作成のように、GPUを使用する作業に適しています。

機器ごとに、CPUアーキテクチャ、Linuxディストリビューション、NVIDIAドライバー、AIランタイムの対応範囲が異なります。インストールする前に、SpaceBuilderのインストールファイルと使用するAIランタイムがその環境に対応しているかを確認してください。

Full簡単インストール（準備中）

インストールファイルのダウンロード

ダウンロードページからLinux用のインストールファイルをダウンロードします。

ダウンロードしたファイルに実行権限を付与します。

chmod +x ~/setfn-spacebuilder

必須ライブラリのインストール

SpaceBuilderは、画像の解析とプレビューの生成のために、コンピューターにインストールされているプログラム（ライブラリ）をあわせて使用します。Ubuntu 24.04以降では、先に次のパッケージをインストールしてください。

sudo apt update
sudo apt install -y \
  libvips42t64 libvips-tools \
  libheif1 libheif-plugin-libde265 \
  libglib2.0-0

パッケージ	使用する機能
`libvips42t64`, `libvips-tools`	画像メタデータの解析、サムネイルの生成、画像形式の変換
`libheif1`, `libheif-plugin-libde265`	HEIC・HEIFコンテナの処理とHEVC画像のデコード
`libglib2.0-0`	libvipsなどのネイティブ画像処理コンポーネントのランタイムサポート

推奨機能パッケージのインストール

SpaceBuilderサーバーは、アップロードされたファイルのOCR、PDF解析、文書のプレビューと形式変換も直接処理します。次のパッケージがなくてもサーバーの基本機能は動作しますが、関連するファイルを処理するときに一部の機能が制限されたり、使用できる変換エンジンが少なくなったりします。

OCRと文書変換の機能をすべて使用するには、次のパッケージをあわせてインストールすることをおすすめします。

sudo apt install -y \
  tesseract-ocr tesseract-ocr-kor tesseract-ocr-jpn \
  poppler-utils \
  libreoffice pandoc

パッケージ	使用する機能	インストールしていない場合
`tesseract-ocr`	画像とスキャンPDFの文字認識（OCR）、基本の英語認識	ローカルのTesseract OCRを使用できない
`tesseract-ocr-kor`	韓国語OCRの言語データ	韓国語の認識精度が低下するか、韓国語OCRを使用できない
`tesseract-ocr-jpn`	日本語OCRの言語データ	日本語OCRを使用できない
`poppler-utils`	PDFのテキスト抽出とページの画像変換（`pdftotext`、`pdftoppm`、`pdftocairo`）	PDFのテキスト抽出とOCR前処理の経路が制限される
`libreoffice`	DOCX、XLSX、PPTXなどのオフィス文書のプレビューとPDF変換	オフィス文書の変換機能が制限される
`pandoc`	DOCX、HTML、Markdownなどの文書形式間の変換	該当する形式の変換経路が制限される

インストール状況は、次のコマンドで確認できます。

vips --version
vips list classes | grep -i heif
tesseract --version
tesseract --list-langs
pdftotext -v
libreoffice --version
pandoc --version

インストーラーの実行

インストールファイルを実行します。

./setfn-spacebuilder

インストーラーは、既定では18510ポートで初期設定ページを開きます。このポートをほかのプログラムが使用している場合は、使用可能な次のポートを自動的に選択するため、必ずターミナルに出力されたアドレスに接続してください。

ブラウザーで初期設定ページが開いたら、利用規約を確認して同意したうえで、管理者アカウントとサービス環境を構成します。詳しい入力項目と注意点は、初期設定で確認してください。

コンピューターの電源を入れたときに自動的に起動する

初期設定が終わったら、SpaceBuilderが常に実行されるように、自動起動を設定することをおすすめします。自動起動を設定すると、次のように動作します。

実行したターミナルを閉じても、SpaceBuilderは動作し続けます。
コンピューターの電源を切って入れ直しても、SpaceBuilderが自動的に起動します。
SpaceBuilderがエラーで終了した場合は、自動的に再起動されます。

Linuxでは、常に実行するプログラムをsystemdという標準の管理機能に登録します。以下のコマンドを順番に実行してください。

1. 自分のユーザー名とファイルの場所を確認する

次の2つのコマンドを1行ずつ実行します。

whoami

realpath ~/setfn-spacebuilder

whoamiは、現在ログインしているユーザー名を表示します。
realpathは、SpaceBuilderの実行ファイルの正確な場所を表示します。

出力された内容は次の手順で使用するため、メモしておいてください。

2. 自動起動の設定ファイルを作成する

SpaceBuilderが現在のターミナルで実行中の場合は、先にCtrl+Cを押して終了します。次のコマンドで、自動起動の設定ファイルを開きます。

sudo nano /etc/systemd/system/setfn-spacebuilder.service

次の内容を貼り付けます。すべての<ユーザー>を手順1で確認したユーザー名に置き換え、ExecStartには確認した実行ファイルの場所を入力してください。

[Unit]
Description=SetFN SpaceBuilder
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=<ユーザー>
WorkingDirectory=/home/<ユーザー>
Environment=HOME=/home/<ユーザー>
ExecStart=/home/<ユーザー>/setfn-spacebuilder
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

nanoでは、Ctrl+O、Enterの順に押して保存し、Ctrl+Xで終了します。

3. 自動起動を有効にする

次のコマンドを1行ずつ実行します。1つ目のコマンドは作成した設定をLinuxに認識させ、2つ目のコマンドはSpaceBuilderを今すぐ起動するとともに、次回の起動時から自動的に起動するようにします。

sudo systemctl daemon-reload

sudo systemctl enable --now setfn-spacebuilder

正常に実行されているかを確認します。

systemctl status setfn-spacebuilder

画面にactive (running)と表示されれば、自動起動の設定は完了です。qを押すと、状態の画面を閉じることができます。

4. 実行されないときに原因を確認する

active (running)と表示されない場合や、SpaceBuilderに接続できない場合は、次のコマンドで最近のログを確認します。

journalctl -u setfn-spacebuilder -n 100 --no-pager

実行の経過をリアルタイムで確認するには、次のコマンドを使用します。確認が終わったら、Ctrl+Cで終了します。

journalctl -u setfn-spacebuilder -f

自動起動の管理コマンド

操作	コマンド
実行状態の確認	`systemctl status setfn-spacebuilder`
再起動	`sudo systemctl restart setfn-spacebuilder`
SpaceBuilderを停止する	`sudo systemctl stop setfn-spacebuilder`
SpaceBuilderを起動する	`sudo systemctl start setfn-spacebuilder`
コンピューターの起動時に自動起動しない	`sudo systemctl disable setfn-spacebuilder`

自動起動の設定ファイルの内容を変更した場合は、sudo systemctl daemon-reloadを実行してからSpaceBuilderを再起動しないと、変更内容は適用されません。

管理者ページにログインできないときに、アカウントやアクセス制限を復旧する方法は、コマンドでサーバーを管理するを参照してください。