---
title: Server local
description: Gestionează serverul Twenty Docker local — pornește, oprește, actualizează, rulează o instanță de testare în paralel și configurează manual SDK-ul.
icon: server
---

## Gestionarea serverului local

Folosiți `yarn twenty server` pentru a controla containerul Twenty local:

| Comandă                                | Ce face                                                      |
| -------------------------------------- | ------------------------------------------------------------ |
| `yarn twenty server start`             | Pornește serverul (descarcă imaginea dacă este necesar)      |
| `yarn twenty server start --port 3030` | Pornește pe un port personalizat                             |
| `yarn twenty server stop`              | Oprește serverul (păstrează datele)                          |
| `yarn twenty server status`            | Afișează URL-ul, versiunea și credențialele de autentificare |
| `yarn twenty server logs`              | Transmite în flux jurnalele serverului                       |
| `yarn twenty server reset`             | Șterge datele și pornește de la zero                         |
| `yarn twenty server upgrade`           | Descarcă cea mai recentă imagine `twenty-app-dev`            |
| `yarn twenty server upgrade 2.2.0`     | Actualizează 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.

```bash filename="Terminal"
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 --test`   | Pornește instanța de test (implicit pe portul 2021) |
| `yarn twenty server stop --test`    | Oprește-o                                           |
| `yarn twenty server status --test`  | Afișează-i starea                                   |
| `yarn twenty server logs --test`    | Transmite în flux jurnalele sale                    |
| `yarn twenty server reset --test`   | Șterge-i datele                                     |
| `yarn twenty server upgrade --test` | Actualizează-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:

```bash filename="Terminal"
yarn add twenty-sdk twenty-client-sdk
```

Adăugați scriptul în `package.json`:

```json filename="package.json"
{
  "scripts": {
    "twenty": "twenty"
  }
}
```

Acum puteți rula `yarn twenty dev`, `yarn twenty server start` și restul.

<Note>
Nu instalați `twenty-sdk` global — fixați-l per proiect astfel încât fiecare aplicație să folosească propria versiune.
</Note>