From f32b03a3ec8c988c77a4e6716671613ca56d7d92 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 16:58:55 +0200
Subject: [PATCH] i18n - docs translations (#20161)

Created by Github action

Co-authored-by: github-actions <github-actions@twenty.com>
---
 .../extend/apps/getting-started.mdx           | 53 +++++++++++++------
 .../extend/apps/getting-started.mdx           | 53 +++++++++++++------
 .../extend/apps/getting-started.mdx           | 53 +++++++++++++------
 .../extend/apps/getting-started.mdx           | 53 +++++++++++++------
 .../extend/apps/getting-started.mdx           | 53 +++++++++++++------
 5 files changed, 180 insertions(+), 85 deletions(-)

diff --git a/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx
index 5b38b6b9e1..7cd593987b 100644
--- a/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx
@@ -213,30 +213,49 @@ Die Beispiele stammen aus dem Verzeichnis [twenty-apps/examples](https://github.
 
 Der Scaffolder hat bereits einen lokalen Twenty-Server für Sie gestartet. Um ihn später zu verwalten, verwenden Sie `yarn twenty server`:
 
-| Befehl                                 | Beschreibung                                                |
-| -------------------------------------- | ----------------------------------------------------------- |
-| `yarn twenty server start`             | Lokalen Server starten (lädt das Image bei Bedarf herunter) |
-| `yarn twenty server start --port 3030` | Auf einem benutzerdefinierten Port starten                  |
-| `yarn twenty server start --test`      | Starten Sie eine separate Testinstanz auf Port 2021         |
-| `yarn twenty server stop`              | Server stoppen (Daten bleiben erhalten)                     |
-| `yarn twenty server status`            | Serverstatus, URL und Anmeldedaten anzeigen                 |
-| `yarn twenty server logs`              | Serverprotokolle streamen                                   |
-| `yarn twenty server logs --lines 100`  | Die letzten 100 Protokollzeilen anzeigen                    |
-| `yarn twenty server reset`             | Alle Daten löschen und neu starten                          |
+| Befehl                                 | Beschreibung                                                                     |
+| -------------------------------------- | -------------------------------------------------------------------------------- |
+| `yarn twenty server start`             | Lokalen Server starten (lädt das Image bei Bedarf herunter)                      |
+| `yarn twenty server start --port 3030` | Auf einem benutzerdefinierten Port starten                                       |
+| `yarn twenty server start --test`      | Starten Sie eine separate Testinstanz auf Port 2021                              |
+| `yarn twenty server stop`              | Server stoppen (Daten bleiben erhalten)                                          |
+| `yarn twenty server status`            | Serverstatus, URL, Version und Anmeldedaten anzeigen                             |
+| `yarn twenty server logs`              | Serverprotokolle streamen                                                        |
+| `yarn twenty server logs --lines 100`  | Die letzten 100 Protokollzeilen anzeigen                                         |
+| `yarn twenty server reset`             | Alle Daten löschen und neu starten                                               |
+| `yarn twenty server upgrade`           | Das neueste `twenty-app-dev`-Image herunterladen und den Container neu erstellen |
+| `yarn twenty server upgrade 2.2.0`     | Auf eine bestimmte Version aktualisieren                                         |
 
 Daten bleiben über Neustarts hinweg in zwei Docker-Volumes bestehen (`twenty-app-dev-data` für PostgreSQL, `twenty-app-dev-storage` für Dateien). Verwenden Sie `reset`, um alles zu löschen und neu zu beginnen.
 
+### Aktualisieren des Server-Images
+
+Verwenden Sie `yarn twenty server upgrade`, um nach einem neueren `twenty-app-dev`-Docker-Image zu suchen und den Container zu aktualisieren. Der Befehl lädt das Image herunter, vergleicht es mit dem, aus dem der Container erstellt wurde, und erstellt den Container nur neu, wenn sich das Image tatsächlich geändert hat. Ihre Daten-Volumes bleiben erhalten — nur der Container wird ersetzt.
+
+```bash filename="Terminal"
+# Upgrade to the latest version (skips recreation if already up to date)
+yarn twenty server upgrade
+
+# Upgrade to a specific version
+yarn twenty server upgrade 2.2.0
+```
+
+Wenn ein neueres Image verfügbar ist und der Container lief, startet der Upgrade-Befehl automatisch einen neuen Container mit dem aktualisierten Image. Führen Sie anschließend `yarn twenty server start` aus, um zu warten, bis er betriebsbereit ist. Wenn sich das Image nicht geändert hat, bleibt der Container unverändert.
+
+Sie können die laufende Version mit `yarn twenty server status` überprüfen; dieser Befehl zeigt die `APP_VERSION` des Containers an.
+
 ### Eine Testinstanz ausführen
 
 Übergeben Sie `--test` an jeden `server`-Befehl, um eine zweite, vollständig isolierte Instanz zu verwalten — nützlich, um Integrationstests auszuführen oder zu experimentieren, ohne Ihre Hauptentwicklungsdaten anzutasten.
 
-| Befehl                             | Beschreibung                                          |
-| ---------------------------------- | ----------------------------------------------------- |
-| `yarn twenty server start --test`  | Die Testinstanz starten (standardmäßig Port 2021)     |
-| `yarn twenty server stop --test`   | Die Testinstanz stoppen                               |
-| `yarn twenty server status --test` | Status, URL und Anmeldedaten der Testinstanz anzeigen |
-| `yarn twenty server logs --test`   | Protokolle der Testinstanz streamen                   |
-| `yarn twenty server reset --test`  | Alle Testdaten löschen und neu starten                |
+| Befehl                              | Beschreibung                                                   |
+| ----------------------------------- | -------------------------------------------------------------- |
+| `yarn twenty server start --test`   | Die Testinstanz starten (standardmäßig Port 2021)              |
+| `yarn twenty server stop --test`    | Die Testinstanz stoppen                                        |
+| `yarn twenty server status --test`  | Status, URL, Version und Anmeldedaten der Testinstanz anzeigen |
+| `yarn twenty server logs --test`    | Protokolle der Testinstanz streamen                            |
+| `yarn twenty server reset --test`   | Alle Testdaten löschen und neu starten                         |
+| `yarn twenty server upgrade --test` | Das Image der Testinstanz aktualisieren                        |
 
 Die Testinstanz läuft in einem eigenen Docker-Container (`twenty-app-dev-test`) mit dedizierten Volumes (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) und eigener Konfiguration, sodass sie parallel zu Ihrer Hauptinstanz ohne Konflikte ausgeführt werden kann. Kombinieren Sie `--test` mit `--port`, um den Standardport 2021 zu überschreiben.
 
diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started.mdx
index e371cd5754..98dab3ebb7 100644
--- a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started.mdx
@@ -213,30 +213,49 @@ Os exemplos são obtidos do diretório [twenty-apps/examples](https://github.com
 
 A ferramenta de scaffolding já iniciou um servidor local do Twenty para você. Para gerenciá-lo depois, use `yarn twenty server`:
 
-| Comando                                | Descrição                                              |
-| -------------------------------------- | ------------------------------------------------------ |
-| `yarn twenty server start`             | Inicia o servidor local (baixa a imagem se necessário) |
-| `yarn twenty server start --port 3030` | Iniciar em uma porta personalizada                     |
-| `yarn twenty server start --test`      | Inicie uma instância de teste separada na porta 2021   |
-| `yarn twenty server stop`              | Interrompe o servidor (preserva os dados)              |
-| `yarn twenty server status`            | Mostra o status do servidor, a URL e as credenciais    |
-| `yarn twenty server logs`              | Transmite os logs do servidor                          |
-| `yarn twenty server logs --lines 100`  | Mostra as últimas 100 linhas de log                    |
-| `yarn twenty server reset`             | Exclui todos os dados e inicia do zero                 |
+| Comando                                | Descrição                                                         |
+| -------------------------------------- | ----------------------------------------------------------------- |
+| `yarn twenty server start`             | Inicia o servidor local (baixa a imagem se necessário)            |
+| `yarn twenty server start --port 3030` | Iniciar em uma porta personalizada                                |
+| `yarn twenty server start --test`      | Inicie uma instância de teste separada na porta 2021              |
+| `yarn twenty server stop`              | Interrompe o servidor (preserva os dados)                         |
+| `yarn twenty server status`            | Mostra o status do servidor, a URL, a versão e as credenciais     |
+| `yarn twenty server logs`              | Transmite os logs do servidor                                     |
+| `yarn twenty server logs --lines 100`  | Mostra as últimas 100 linhas de log                               |
+| `yarn twenty server reset`             | Exclui todos os dados e inicia do zero                            |
+| `yarn twenty server upgrade`           | Baixe a imagem mais recente `twenty-app-dev` e recrie o contêiner |
+| `yarn twenty server upgrade 2.2.0`     | Atualizar para uma versão específica                              |
 
 Os dados são persistidos entre reinicializações em dois volumes do Docker (`twenty-app-dev-data` para PostgreSQL, `twenty-app-dev-storage` para arquivos). Use `reset` para apagar tudo e começar do zero.
 
+### Atualizando a imagem do servidor
+
+Use `yarn twenty server upgrade` para verificar se há uma imagem do Docker `twenty-app-dev` mais recente e atualizar o container. O comando baixa a imagem, a compara com aquela a partir da qual o container foi criado e só recria o container se a imagem realmente tiver sido alterada. Seus volumes de dados são preservados — apenas o container é substituído.
+
+```bash filename="Terminal"
+# Upgrade to the latest version (skips recreation if already up to date)
+yarn twenty server upgrade
+
+# Upgrade to a specific version
+yarn twenty server upgrade 2.2.0
+```
+
+Se uma imagem mais recente estiver disponível e o container estiver em execução, o comando de atualização iniciará automaticamente um novo container com a imagem atualizada. Em seguida, execute `yarn twenty server start` para aguardar até que ele fique saudável. Se a imagem não tiver mudado, o container permanece inalterado.
+
+Você pode verificar a versão em execução com `yarn twenty server status`, que exibe o `APP_VERSION` do container.
+
 ### Executando uma instância de teste
 
 Passe `--test` para qualquer comando de `server` para gerenciar uma segunda instância totalmente isolada — útil para executar testes de integração ou experimentar sem tocar nos seus dados principais de desenvolvimento.
 
-| Comando                            | Descrição                                                     |
-| ---------------------------------- | ------------------------------------------------------------- |
-| `yarn twenty server start --test`  | Inicia a instância de teste (padrão: porta 2021)              |
-| `yarn twenty server stop --test`   | Interrompe a instância de teste                               |
-| `yarn twenty server status --test` | Mostra o status da instância de teste, a URL e as credenciais |
-| `yarn twenty server logs --test`   | Transmite os logs da instância de teste                       |
-| `yarn twenty server reset --test`  | Exclui os dados de teste e inicia do zero                     |
+| Comando                             | Descrição                                                               |
+| ----------------------------------- | ----------------------------------------------------------------------- |
+| `yarn twenty server start --test`   | Inicia a instância de teste (padrão: porta 2021)                        |
+| `yarn twenty server stop --test`    | Interrompe a instância de teste                                         |
+| `yarn twenty server status --test`  | Mostra o status da instância de teste, a URL, a versão e as credenciais |
+| `yarn twenty server logs --test`    | Transmite os logs da instância de teste                                 |
+| `yarn twenty server reset --test`   | Exclui os dados de teste e inicia do zero                               |
+| `yarn twenty server upgrade --test` | Atualiza a imagem da instância de teste                                 |
 
 A instância de teste é executada em seu próprio contêiner Docker (`twenty-app-dev-test`) com volumes dedicados (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) e configuração própria, para que possa ser executada em paralelo com sua instância principal sem conflitos. Combine `--test` com `--port` para substituir a porta padrão 2021.
 
diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx
index 2f2f4ff187..454bfe3874 100644
--- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx
@@ -213,30 +213,49 @@ npx create-twenty-app@latest my-twenty-app --example postcard
 
 Генератор каркаса уже запустил для вас локальный сервер Twenty. Чтобы управлять им позже, используйте `yarn twenty server`:
 
-| Команда                                | Описание                                                       |
-| -------------------------------------- | -------------------------------------------------------------- |
-| `yarn twenty server start`             | Запустить локальный сервер (при необходимости скачивает образ) |
-| `yarn twenty server start --port 3030` | Запустить на пользовательском порту                            |
-| `yarn twenty server start --test`      | Запускает отдельный тестовый экземпляр на порту 2021           |
-| `yarn twenty server stop`              | Остановить сервер (данные сохраняются)                         |
-| `yarn twenty server status`            | Показать состояние сервера, URL и учётные данные               |
-| `yarn twenty server logs`              | Потоковый вывод журналов сервера                               |
-| `yarn twenty server logs --lines 100`  | Показать последние 100 строк журнала                           |
-| `yarn twenty server reset`             | Удалить все данные и начать с чистого листа                    |
+| Команда                                | Описание                                                           |
+| -------------------------------------- | ------------------------------------------------------------------ |
+| `yarn twenty server start`             | Запустить локальный сервер (при необходимости скачивает образ)     |
+| `yarn twenty server start --port 3030` | Запустить на пользовательском порту                                |
+| `yarn twenty server start --test`      | Запускает отдельный тестовый экземпляр на порту 2021               |
+| `yarn twenty server stop`              | Остановить сервер (данные сохраняются)                             |
+| `yarn twenty server status`            | Показать состояние сервера, URL, версию и учётные данные           |
+| `yarn twenty server logs`              | Потоковый вывод журналов сервера                                   |
+| `yarn twenty server logs --lines 100`  | Показать последние 100 строк журнала                               |
+| `yarn twenty server reset`             | Удалить все данные и начать с чистого листа                        |
+| `yarn twenty server upgrade`           | Загрузить последний образ `twenty-app-dev` и пересоздать контейнер |
+| `yarn twenty server upgrade 2.2.0`     | Upgrade to a specific version                                      |
 
 Данные сохраняются между перезапусками в двух томах Docker (`twenty-app-dev-data` для PostgreSQL, `twenty-app-dev-storage` для файлов). Используйте `reset`, чтобы стереть всё и начать заново.
 
+### Upgrading the server image
+
+Use `yarn twenty server upgrade` to check for a newer `twenty-app-dev` Docker image and update the container. The command pulls the image, compares it against the one the container was created from, and only recreates the container if the image actually changed. Your data volumes are preserved — only the container is replaced.
+
+```bash filename="Terminal"
+# Upgrade to the latest version (skips recreation if already up to date)
+yarn twenty server upgrade
+
+# Upgrade to a specific version
+yarn twenty server upgrade 2.2.0
+```
+
+If a newer image is available and the container was running, the upgrade command automatically starts a new container with the updated image. Run `yarn twenty server start` afterward to wait for it to become healthy. If the image hasn't changed, the container is left untouched.
+
+You can verify the running version with `yarn twenty server status`, which displays the `APP_VERSION` from the container.
+
 ### Запуск тестового экземпляра
 
 Передайте `--test` любой команде `server`, чтобы управлять вторым, полностью изолированным экземпляром — это полезно для запуска интеграционных тестов или экспериментов, не затрагивая ваши основные данные разработки.
 
-| Команда                            | Описание                                                      |
-| ---------------------------------- | ------------------------------------------------------------- |
-| `yarn twenty server start --test`  | Запустить тестовый экземпляр (по умолчанию — порт 2021)       |
-| `yarn twenty server stop --test`   | Остановить тестовый экземпляр                                 |
-| `yarn twenty server status --test` | Показать состояние тестового экземпляра, URL и учётные данные |
-| `yarn twenty server logs --test`   | Выводить журналы тестового экземпляра в потоковом режиме      |
-| `yarn twenty server reset --test`  | Удалить тестовые данные и начать с чистого листа              |
+| Команда                             | Описание                                                 |
+| ----------------------------------- | -------------------------------------------------------- |
+| `yarn twenty server start --test`   | Запустить тестовый экземпляр (по умолчанию — порт 2021)  |
+| `yarn twenty server stop --test`    | Остановить тестовый экземпляр                            |
+| `yarn twenty server status --test`  | Show test instance status, URL, version, and credentials |
+| `yarn twenty server logs --test`    | Выводить журналы тестового экземпляра в потоковом режиме |
+| `yarn twenty server reset --test`   | Удалить тестовые данные и начать с чистого листа         |
+| `yarn twenty server upgrade --test` | Upgrade the test instance image                          |
 
 Тестовый экземпляр запускается в собственном контейнере Docker (`twenty-app-dev-test`) с выделенными томами (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) и собственной конфигурацией, поэтому он может работать параллельно с вашим основным экземпляром без конфликтов. Совместите `--test` с `--port`, чтобы переопределить значение по умолчанию (2021).
 
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx
index 043cd61851..c5320e8f57 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx
@@ -213,30 +213,49 @@ npx create-twenty-app@latest my-twenty-app --example postcard
 
 İskelet oluşturucu sizin için zaten yerel bir Twenty sunucusu başlattı. Daha sonra yönetmek için `yarn twenty server` komutunu kullanın:
 
-| Komut                                  | Açıklama                                                        |
-| -------------------------------------- | --------------------------------------------------------------- |
-| `yarn twenty server start`             | Yerel sunucuyu başlatır (gerekirse imajı çeker)                 |
-| `yarn twenty server start --port 3030` | Özel bir portta başlatır                                        |
-| `yarn twenty server start --test`      | 2021 numaralı bağlantı noktasında ayrı bir test örneği başlatın |
-| `yarn twenty server stop`              | Sunucuyu durdurur (verileri korur)                              |
-| `yarn twenty server status`            | Sunucu durumunu, URL'yi ve kimlik bilgilerini gösterir          |
-| `yarn twenty server logs`              | Sunucu günlüklerini akış olarak iletir                          |
-| `yarn twenty server logs --lines 100`  | Son 100 günlük satırını gösterir                                |
-| `yarn twenty server reset`             | Tüm verileri siler ve sıfırdan başlatır                         |
+| Komut                                  | Açıklama                                                              |
+| -------------------------------------- | --------------------------------------------------------------------- |
+| `yarn twenty server start`             | Yerel sunucuyu başlatır (gerekirse imajı çeker)                       |
+| `yarn twenty server start --port 3030` | Özel bir portta başlatır                                              |
+| `yarn twenty server start --test`      | 2021 numaralı bağlantı noktasında ayrı bir test örneği başlatın       |
+| `yarn twenty server stop`              | Sunucuyu durdurur (verileri korur)                                    |
+| `yarn twenty server status`            | Sunucu durumunu, URL'yi, sürümü ve kimlik bilgilerini gösterir        |
+| `yarn twenty server logs`              | Sunucu günlüklerini akış olarak iletir                                |
+| `yarn twenty server logs --lines 100`  | Son 100 günlük satırını gösterir                                      |
+| `yarn twenty server reset`             | Tüm verileri siler ve sıfırdan başlatır                               |
+| `yarn twenty server upgrade`           | En son `twenty-app-dev` imajını çeker ve konteyneri yeniden oluşturur |
+| `yarn twenty server upgrade 2.2.0`     | Upgrade to a specific version                                         |
 
 Veriler, yeniden başlatmalar arasında iki Docker biriminde kalıcıdır (PostgreSQL için `twenty-app-dev-data`, dosyalar için `twenty-app-dev-storage`). Her şeyi silip baştan başlamak için `reset` kullanın.
 
+### Upgrading the server image
+
+Use `yarn twenty server upgrade` to check for a newer `twenty-app-dev` Docker image and update the container. The command pulls the image, compares it against the one the container was created from, and only recreates the container if the image actually changed. Your data volumes are preserved — only the container is replaced.
+
+```bash filename="Terminal"
+# Upgrade to the latest version (skips recreation if already up to date)
+yarn twenty server upgrade
+
+# Upgrade to a specific version
+yarn twenty server upgrade 2.2.0
+```
+
+If a newer image is available and the container was running, the upgrade command automatically starts a new container with the updated image. Run `yarn twenty server start` afterward to wait for it to become healthy. If the image hasn't changed, the container is left untouched.
+
+You can verify the running version with `yarn twenty server status`, which displays the `APP_VERSION` from the container.
+
 ### Test örneği çalıştırma
 
 `server` komutlarının herhangi birine `--test` parametresini vererek ikinci, tamamen yalıtılmış bir örneği yönetin — entegrasyon testlerini çalıştırmak veya ana geliştirme verilerinize dokunmadan denemeler yapmak için kullanışlıdır.
 
-| Komut                              | Açıklama                                                       |
-| ---------------------------------- | -------------------------------------------------------------- |
-| `yarn twenty server start --test`  | Test örneğini başlatır (varsayılan bağlantı noktası 2021'dir)  |
-| `yarn twenty server stop --test`   | Test örneğini durdurur                                         |
-| `yarn twenty server status --test` | Test örneğinin durumunu, URL'yi ve kimlik bilgilerini gösterir |
-| `yarn twenty server logs --test`   | Test örneği günlüklerini akış olarak iletir                    |
-| `yarn twenty server reset --test`  | Test verilerini siler ve sıfırdan başlatır                     |
+| Komut                               | Açıklama                                                      |
+| ----------------------------------- | ------------------------------------------------------------- |
+| `yarn twenty server start --test`   | Test örneğini başlatır (varsayılan bağlantı noktası 2021'dir) |
+| `yarn twenty server stop --test`    | Test örneğini durdurur                                        |
+| `yarn twenty server status --test`  | Show test instance status, URL, version, and credentials      |
+| `yarn twenty server logs --test`    | Test örneği günlüklerini akış olarak iletir                   |
+| `yarn twenty server reset --test`   | Test verilerini siler ve sıfırdan başlatır                    |
+| `yarn twenty server upgrade --test` | Upgrade the test instance image                               |
 
 Test örneği, kendine ait bir Docker konteynerinde (`twenty-app-dev-test`), ayrılmış birimlerle (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) ve yapılandırmayla çalışır; böylece ana örneğinizle çakışma olmadan paralel olarak çalışabilir. Varsayılan 2021'i geçersiz kılmak için `--test` ile `--port`'u birlikte kullanın.
 
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx
index 72dd9bed77..7e7b91a1ac 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx
@@ -213,30 +213,49 @@ npx create-twenty-app@latest my-twenty-app --example postcard
 
 脚手架工具已经为你启动了一个本地 Twenty 服务器。 稍后要进行管理，请使用 `yarn twenty server`：
 
-| 命令                                     | 描述                   |
-| -------------------------------------- | -------------------- |
-| `yarn twenty server start`             | 启动本地服务器（按需拉取镜像）      |
-| `yarn twenty server start --port 3030` | 在自定义端口启动             |
-| `yarn twenty server start --test`      | 在 2021 端口启动一个独立的测试实例 |
-| `yarn twenty server stop`              | 停止服务器（保留数据）          |
-| `yarn twenty server status`            | 显示服务器状态、URL 和凭据      |
-| `yarn twenty server logs`              | 流式输出服务器日志            |
-| `yarn twenty server logs --lines 100`  | 显示最近 100 行日志         |
-| `yarn twenty server reset`             | 删除所有数据并全新开始          |
+| 命令                                     | 描述                               |
+| -------------------------------------- | -------------------------------- |
+| `yarn twenty server start`             | 启动本地服务器（按需拉取镜像）                  |
+| `yarn twenty server start --port 3030` | 在自定义端口启动                         |
+| `yarn twenty server start --test`      | 在 2021 端口启动一个独立的测试实例             |
+| `yarn twenty server stop`              | 停止服务器（保留数据）                      |
+| `yarn twenty server status`            | 显示服务器状态、URL、版本和凭据                |
+| `yarn twenty server logs`              | 流式输出服务器日志                        |
+| `yarn twenty server logs --lines 100`  | 显示最近 100 行日志                     |
+| `yarn twenty server reset`             | 删除所有数据并全新开始                      |
+| `yarn twenty server upgrade`           | 拉取最新的 `twenty-app-dev` 镜像并重新创建容器 |
+| `yarn twenty server upgrade 2.2.0`     | 升级到指定版本                          |
 
 数据在重启后会保留，存储于两个 Docker 卷中（`twenty-app-dev-data` 用于 PostgreSQL，`twenty-app-dev-storage` 用于文件）。 使用 `reset` 清空所有内容并重新开始。
 
+### 升级服务器镜像
+
+使用 `yarn twenty server upgrade` 来检查是否有更新的 `twenty-app-dev` Docker 镜像并更新容器。 该命令会拉取镜像，与容器创建时所用的镜像进行比较，仅当镜像确实发生变化时才会重新创建容器。 您的数据卷将被保留——只会替换容器。
+
+```bash filename="Terminal"
+# Upgrade to the latest version (skips recreation if already up to date)
+yarn twenty server upgrade
+
+# Upgrade to a specific version
+yarn twenty server upgrade 2.2.0
+```
+
+如果有可用的新镜像且容器正在运行，升级命令会使用更新后的镜像自动启动一个新容器。 随后运行 `yarn twenty server start`，等待其变为健康状态。 如果镜像没有变化，容器将保持不变。
+
+您可以使用 `yarn twenty server status` 验证正在运行的版本，该命令会显示容器中的 `APP_VERSION`。
+
 ### 运行测试实例
 
 向任何 `server` 命令传递 `--test` 以管理第二个、完全隔离的实例——这对于运行集成测试或在不影响主开发数据的情况下进行试验非常有用。
 
-| 命令                                 | 描述                  |
-| ---------------------------------- | ------------------- |
-| `yarn twenty server start --test`  | 启动测试实例 (默认端口为 2021) |
-| `yarn twenty server stop --test`   | 停止测试实例              |
-| `yarn twenty server status --test` | 显示测试实例状态、URL 和凭据    |
-| `yarn twenty server logs --test`   | 流式输出测试实例日志          |
-| `yarn twenty server reset --test`  | 清除测试数据并全新开始         |
+| 命令                                  | 描述                  |
+| ----------------------------------- | ------------------- |
+| `yarn twenty server start --test`   | 启动测试实例 (默认端口为 2021) |
+| `yarn twenty server stop --test`    | 停止测试实例              |
+| `yarn twenty server status --test`  | 显示测试实例状态、URL、版本和凭据  |
+| `yarn twenty server logs --test`    | 流式输出测试实例日志          |
+| `yarn twenty server reset --test`   | 清除测试数据并全新开始         |
+| `yarn twenty server upgrade --test` | 升级测试实例镜像            |
 
 测试实例在其独立的 Docker 容器 (`twenty-app-dev-test`) 中运行，配有专用的卷 (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) 和配置，因此可以与主实例并行运行且不会发生冲突。 将 `--test` 与 `--port` 一起使用以覆盖默认的 2021 端口。