Skip to main content
このドキュメントでは、セルフホストの Teable 環境をアップグレードする方法を説明します。

​
リリースチャンネルとバージョンタグ

Teable アプリでは、release.<timestamp>.<build> 形式（例：release.2026-07-14T12-24-39Z.2228）の日付ベースのリリースタグと、継続的に更新される2つのチャンネルを公開しています。 リリースは頻繁に（多くの場合、週に数回）提供されます。アップグレードのタイミングは利用者が決定します。すべてのタグは GitHub Packages に掲載されています。
アップグレードを実行する前に、データをバックアップすることを強く推奨します。

​
通常の更新：変更履歴に従う

新機能と修正は変更履歴で告知され、Teable の各リリースタグにはビルド日が含まれます。そのため、目的の機能を利用できるかどうかは日付で比較できます。告知で読んだ内容を利用するには、その項目の日付以降の Teable イメージへ移行します。
  • Docker 環境では、そのまま latest チャンネルを利用できます。
    コンテナは新しいイメージで再作成されます。データは Docker ボリューム（または外部データベース）に保存されており、変更されません。
  • Kubernetes 環境では、継続的に変わるタグを使用しないでください。Teable イメージを固定し、更新のたびに固定タグを意図的に変更します。デプロイリポジトリの pin-image.sh は、latest が現在指している具体的なリリースを特定します。

​
推奨手順：プラットフォーム全体をまとめてアップグレードする

フル機能のデプロイには、Teable アプリとプラットフォーム自体という2つのバージョン系列があります（アーキテクチャを参照）。最も確実な通常手順では、VERSIONS.md をアップグレード一覧として使用し、両方を連動させます。更新ごとに次の手順を実行します。
  1. ランタイムプレーンを最新のプラットフォームリリース（v<year>.<month>.<seq>）へアップグレードします。各 Git タグはすべてのランタイムコンポーネントの検証済みスナップショットであり、CHANGELOG.md の項目に、変更内容と必要な作業が記載されています（ほとんどのリリースは稼働中に交換できます）。そのタグをチェックアウトしたリポジトリで作業します。
  2. Teable アプリを、latest が現在指している具体的なリリースタグへ移行します（pin-image.sh で特定できます）。継続的に変わるチャンネルではなく、固定された検証済みの組み合わせを使用します。
  3. 付属の診断を実行します。正常性を確認し、実際に稼働している内容をプラットフォームのリリースマニフェストと比較して、「互換性あり」「Teable アプリのアップグレードが必要」「不明な組み合わせ」のいずれかを報告します。

​
必須のシークレット

Teable は、組み込みのデフォルトシークレットを代替として使用しなくなりました。デプロイがこれらのデフォルト値に依存していた場合、アップグレード後の初回起動時に停止し、必要な環境変数の一覧と、既存のセッション、トークン、暗号化データを維持するためのコピー＆ペースト用ブロックが表示されます。そのブロックを追加して再起動し、その後ローテーションを計画してください。シークレットとローテーションを参照してください。

​
データベースの移行

Teable は起動時にデータベース移行を自動実行するため、手動操作は不要です。アップグレード後に問題がある場合は、ログを確認します。

​
ロールバック

アップグレード後に問題が発生した場合：
  1. docker-compose.yaml のイメージタグを以前のリリースタグに戻します（latest より固定タグが優れている理由です。以前のバージョンが明記されています）。
  2. docker compose up -d
データベーススキーマを移行したリリースからのアップグレード後にロールバックすることは、安全でない場合があります。その場合は、アップグレード前のバックアップから復元してください。これが、上記でバックアップを推奨している主な理由です。

​
よくある質問

いいえ。データは Docker ボリュームまたは外部データベースに保存されており、コンテナのアップグレードによる影響はありません。ただし、アップグレード前のバックアップは引き続き推奨します。
いいえ、アプリケーションを更新してもインスタンスIDは変わりません。セルフホスト環境を示す恒久的な識別子です。
通常、新しいイメージの取得には数分（ネットワーク速度によって異なります）、コンテナの再起動には数秒しかかかりません。全体の処理は通常5～10分以内に完了します。
docker compose up -d を使用すると、短時間（通常は数秒から数十秒）サービスが中断します。
現在のバージョンは次の方法で確認できます。
  • Teable インターフェースの左下にあるバージョン番号を確認します
  • 管理者アカウントでシステム管理を開きます
  • docker inspect <container> --format='{{.Config.Image}}' を実行してイメージのバージョンを確認します。latest チャンネルを使用している場合、フル機能のデプロイに含まれる pin-image.sh ヘルパーを使うと、latest が現在どのリリースを指しているか特定できます。
  1. まずコンテナのログを確認して問題を調査します：docker compose logs teable
  2. データベース移行の問題であれば、バックアップからの復元を試します
  3. 問題が解決しない場合は、以前のバージョンにロールバックします
  4. support@teable.ai でサポートに問い合わせます
最終更新日 2026年9月4日