ホーム / 使い方 / アップデート

Inkubus をアップデートする

新しいバージョンの zip を note の販売記事からダウンロードしたら、この手順で既存のインストールを更新します。作品データ（server/data/ と server/output/）はアップデートで消えません。

npm install ではなく npm ci を使ってください。package-lock.json に厳密に従ってインストールします（npm install はロックを書き換える可能性があります）。

01 全体の流れ

所要はおよそ 5〜10 分です。

npm run dev のターミナルで Ctrl+C。キューを稼働中なら、バッチ完了を待つかジョブ画面から先に停止しておくと安全です。

スキーマ変更時は Inkubus が自動バックアップを取りますが、手元にもコピーを残すと安心です。server/data/app.sqlite と server/output/ を別の場所にコピーするだけで OK。サーバをきちんと停止していれば app.sqlite 1 つで足ります。

配布 zip は常に inkubus/ という名前のフォルダで展開されます。既存の inkubus/ の上に上書きすれば OK。server/data/ と server/output/ は zip に含まれないので消えません。

zip を右クリック → 「すべて展開」。展開先は既存の inkubus フォルダの 1 つ上の階層を指定（末尾に \inkubus-x.y.z が付いていたら消す）。「同名のファイルがあります」と聞かれたら「ファイルを置き換える」。

cd ~/code   # 既存が ~/code/inkubus/ の場合
unzip -o ~/Downloads/inkubus-x.y.z.zip

-o は「確認なしで上書き」のオプションです。

不安な場合は、新 zip を別の空フォルダに展開してから、旧フォルダの server/data/ と server/output/ をコピーしても同じ結果になります。

cd inkubus
npm ci

新バージョンでは依存ライブラリが増減することがあるので npm ci は必須です。server/ と web/ 両方の依存が同時に入ります。

npm run dev

ブラウザで http://localhost:5173（Chrome 推奨）を開き、ヘッダや About 画面のバージョン表示が新しいか、ライブラリで過去の作品が見えるかを確認してください。

DB スキーマが変わるアップデートでは、起動時にスキーマ更新の直前に SQLite を自動バックアップします。