> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# バージョンアップグレード

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

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

Teable アプリでは、`release.<timestamp>.<build>` 形式（例：`release.2026-07-14T12-24-39Z.2228`）の**日付ベースのリリースタグ**と、継続的に更新される2つのチャンネルを公開しています。

| タグ                            | 意味                                |
| ----------------------------- | --------------------------------- |
| `latest`                      | **安定版**チャンネル — 常に最新の安定版リリースを指します  |
| `beta`                        | 継続的に更新されるチャンネル — 安定版より先行した最新ビルドです |
| `release.<timestamp>.<build>` | 変更されない特定のリリースです                   |

リリースは頻繁に（多くの場合、週に数回）提供されます。アップグレードのタイミングは利用者が決定します。すべてのタグは [GitHub Packages](https://github.com/teableio/teable/pkgs/container/teable) に掲載されています。

<Note>
  アップグレードを実行する前に、データをバックアップすることを強く推奨します。
</Note>

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

新機能と修正は[変更履歴](/ja/changelog)で告知され、Teable の各リリースタグにはビルド日が含まれます。そのため、目的の機能を利用できるかどうかは日付で比較できます。告知で読んだ内容を利用するには、その項目の日付以降の Teable イメージへ移行します。

* **Docker 環境**では、そのまま `latest` チャンネルを利用できます。

  ```bash theme={null}
  cd teable          # デプロイ先のディレクトリ
  docker compose pull
  docker compose up -d
  ```

  コンテナは新しいイメージで再作成されます。データは Docker ボリューム（または外部データベース）に保存されており、変更されません。

* **Kubernetes 環境**では、継続的に変わるタグを使用しないでください。Teable イメージを固定し、**更新のたびに固定タグを意図的に変更**します。デプロイリポジトリの `pin-image.sh` は、`latest` が現在指している具体的なリリースを特定します。

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

フル機能のデプロイには、Teable アプリとプラットフォーム自体という2つのバージョン系列があります（[アーキテクチャ](/ja/deploy/architecture)を参照）。最も確実な通常手順では、[`VERSIONS.md`](https://github.com/teableio/teable-deployment/blob/main/VERSIONS.md) をアップグレード一覧として使用し、両方を連動させます。更新ごとに次の手順を実行します。

1. ランタイムプレーンを**最新のプラットフォームリリース**（`v<year>.<month>.<seq>`）へアップグレードします。各 Git タグはすべてのランタイムコンポーネントの検証済みスナップショットであり、[`CHANGELOG.md`](https://github.com/teableio/teable-deployment/blob/main/CHANGELOG.md) の項目に、変更内容と必要な作業が記載されています（ほとんどのリリースは稼働中に交換できます）。そのタグをチェックアウトしたリポジトリで作業します。
2. Teable アプリを、**`latest` が現在指している具体的なリリースタグ**へ移行します（`pin-image.sh` で特定できます）。継続的に変わるチャンネルではなく、固定された検証済みの組み合わせを使用します。
3. 付属の**診断**を実行します。正常性を確認し、実際に稼働している内容をプラットフォームのリリースマニフェストと比較して、「互換性あり」「Teable アプリのアップグレードが必要」「不明な組み合わせ」のいずれかを報告します。

## 必須のシークレット

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

## データベースの移行

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

```bash theme={null}
docker compose logs teable | grep -i migration
```

## ロールバック

アップグレード後に問題が発生した場合：

1. `docker-compose.yaml` のイメージタグを以前のリリースタグに戻します（`latest` より固定タグが優れている理由です。以前のバージョンが明記されています）。
2. `docker compose up -d`

<Warning>
  データベーススキーマを移行したリリースからの**アップグレード後**にロールバックすることは、安全でない場合があります。その場合は、アップグレード前のバックアップから復元してください。これが、上記でバックアップを推奨している主な理由です。
</Warning>

## よくある質問

<Accordion title="アップグレード後にデータを失うことはありますか？">
  いいえ。データは Docker ボリュームまたは外部データベースに保存されており、コンテナのアップグレードによる影響はありません。ただし、アップグレード前のバックアップは引き続き推奨します。
</Accordion>

<Accordion title="アップグレード後にインスタンスIDは変わりますか？">
  いいえ、アプリケーションを更新してもインスタンスIDは変わりません。セルフホスト環境を示す恒久的な識別子です。
</Accordion>

<Accordion title="アップグレードにはどのくらい時間がかかりますか？">
  通常、新しいイメージの取得には数分（ネットワーク速度によって異なります）、コンテナの再起動には数秒しかかかりません。全体の処理は通常5～10分以内に完了します。
</Accordion>

<Accordion title="アップグレード中にサービスは中断しますか？">
  `docker compose up -d` を使用すると、短時間（通常は数秒から数十秒）サービスが中断します。
</Accordion>

<Accordion title="現在実行中のバージョンを確認するにはどうすればよいですか？">
  現在のバージョンは次の方法で確認できます。

  * Teable インターフェースの左下にあるバージョン番号を確認します
  * 管理者アカウントでシステム管理を開きます
  * `docker inspect <container> --format='{{.Config.Image}}'` を実行してイメージのバージョンを確認します。`latest` チャンネルを使用している場合、フル機能のデプロイに含まれる `pin-image.sh` ヘルパーを使うと、`latest` が現在どのリリースを指しているか特定できます。
</Accordion>

<Accordion title="アップグレードに失敗した場合はどうすればよいですか？">
  1. まずコンテナのログを確認して問題を調査します：`docker compose logs teable`
  2. データベース移行の問題であれば、バックアップからの復元を試します
  3. 問題が解決しない場合は、以前のバージョンにロールバックします
  4. [support@teable.ai](mailto:support@teable.ai) でサポートに問い合わせます
</Accordion>