Přejít na hlavní obsah

Documentation Index

Fetch the complete documentation index at: https://docs.twenty.com/llms.txt

Use this file to discover all available pages before exploring further.

Obecné pokyny

Před zahájením procesu aktualizace vždy zálohujte svou databázi spuštěním:
docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql
Pro obnovení ze zálohy:
cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}
Pokud používáte Docker Compose, postupujte takto:
  1. Zastavte Twenty: docker compose down
  2. Změňte hodnotu TAG v souboru .env vedle docker-compose.yml
  3. Spusťte Twenty: docker compose up -d
Server při startu automaticky spustí všechny požadované migrační kroky upgradu. Není potřeba žádný ruční příkaz.

Upgrade napříč verzemi (v1.22+)

Počínaje v1.22 podporuje Twenty upgrade napříč verzemi. Můžete přejít přímo z jakékoli podporované verze na nejnovější vydání, aniž byste museli procházet každou meziverzí. Například přechod z v1.22 přímo na v2.0 je plně podporován.

Kontrola stavu upgradu

Příkaz upgrade:status vám umožní zkontrolovat aktuální stav vaší instance a migrací pracovních prostorů. Je užitečný pro ladění problémů s upgradem nebo při podávání požadavku na podporu. Spusťte jej z kontejneru serveru:
docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status
Ukázkový výstup:
APP_VERSION: v1.23.0

Instance
    Inferred version: 1.23.0
    Latest command:   1.23.0_DropWorkspaceVersionColumnFastInstanceCommand_1785000000000
    Status:           Up to date
    Executed by:      v1.23.0
    At:               2026-04-16T11:43:58.823Z

Workspace
  Apple (20202020-1c25-4d02-bf25-6aeccf7ea419)
      Inferred version: 1.23.0
      Latest command:   1.23.0_UpdateGlobalObjectContextCommandMenuItemsCommand_1780000005000
      Status:           Up to date
      Executed by:      v1.23.0
      At:               2026-04-16T11:44:09.361Z

Summary
    Instance: Up to date
    Workspaces: 1 up to date, 0 behind, 0 failed (1 total)

Možnosti

PřepínačPopis
-w, --workspace-id <id>Omezí se na konkrétní pracovní prostor. Lze zadat vícekrát.
-f, --failed-onlySkryje aktuální pracovní prostory; zobrazí pouze ty, které jsou pozadu, a neúspěšné.

Řešení potíží

Pokud upgrade selže u některých pracovních prostorů, server nepokročí za chybující krok. Restartování serveru (docker compose up -d) zkusí upgrade znovu od místa, kde se zastavil. Pro rychlou identifikaci problémů spusťte:
docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status --failed-only
Tímto se zobrazí pouze pracovní prostory, které jsou pozadu nebo selhaly, spolu s chybovou zprávou pro každé selhání.

Před v1.22

Pokud je vaše instance starší než v1.22, musíte upgradovat postupně přes každou hlavní označenou verzi (z v1.6 na v1.7, poté z v1.7 na v1.8 atd.), dokud nedosáhnete v1.22. Odtud můžete přejít přímo na nejnovější verzi.