Salt la conținutul principal

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.

Gestionarea serverului local

Folosiți yarn twenty server pentru a controla containerul Twenty local:
ComandăCe face
yarn twenty server startPornește serverul (descarcă imaginea dacă este necesar)
yarn twenty server start --port 3030Pornește pe un port personalizat
yarn twenty server stopOprește serverul (păstrează datele)
yarn twenty server statusAfișează URL-ul, versiunea și credențialele de autentificare
yarn twenty server logsTransmite în flux jurnalele serverului
yarn twenty server resetȘterge datele și pornește de la zero
yarn twenty server upgradeDescarcă cea mai recentă imagine twenty-app-dev
yarn twenty server upgrade 2.2.0Actualizează la o versiune specifică
Datele persistă între reporniri în două volume Docker (twenty-app-dev-data pentru PostgreSQL, twenty-app-dev-storage pentru fișiere). Folosiți reset pentru a șterge totul.

Actualizarea imaginii serverului

yarn twenty server upgrade descarcă cea mai recentă imagine, compară digest-urile și recreează containerul doar dacă s-a schimbat ceva. Volumele de date sunt păstrate — doar containerul este înlocuit. Dacă a fost descărcată o imagine nouă și containerul rula, actualizarea pornește automat un container nou; rulați apoi yarn twenty server start pentru a aștepta până când devine funcțional.
yarn twenty server upgrade            # Latest
yarn twenty server upgrade 2.2.0      # Specific version
Puteți verifica versiunea care rulează cu yarn twenty server status (aceasta afișează APP_VERSION încorporat în container).

Rularea unei instanțe de test în paralel

Adăugați --test la orice comandă server pentru a gestiona o a doua instanță, complet izolată — utilă pentru teste de integrare sau pentru a experimenta fără a atinge datele principale de dezvoltare:
ComandăCe face
yarn twenty server start --testPornește instanța de test (implicit pe portul 2021)
yarn twenty server stop --testOpriți-o
yarn twenty server status --testAfișați-i starea
yarn twenty server logs --testTransmiteți în flux jurnalele sale
yarn twenty server reset --testȘtergeți-i datele
yarn twenty server upgrade --testActualizați-i imaginea
Instanța de test are propriul container (twenty-app-dev-test), propriile volume (twenty-app-dev-test-data, twenty-app-dev-test-storage) și propria configurație — rulează alături de instanța principală, fără conflicte. Combinați --test cu --port pentru a înlocui portul 2021.

Configurare manuală (fără generator)

Săriți peste generatorul de schelet dacă adăugați SDK-ul într-un proiect existent:
yarn add twenty-sdk twenty-client-sdk
Adăugați scriptul în package.json:
{
  "scripts": {
    "twenty": "twenty"
  }
}
Acum puteți rula yarn twenty dev, yarn twenty server start și restul.
Nu instalați twenty-sdk global — fixați-l per proiect astfel încât fiecare aplicație să folosească propria versiune.