---
title: Guia d'actualització
image: /images/user-guide/notes/notes_header.png
---

<Frame>
  <img src="/images/user-guide/notes/notes_header.png" alt="Header" />
</Frame>

## Directrius generals

**Always make sure to back up your database before starting the upgrade process** by running `docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql`.

To restore backup, run `cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}`.

Si heu utilitzat Docker Compose, seguiu aquests passos:

1. En un terminal, a l'ordinador on s'executa Twenty, apagueu Twenty: `docker compose down`

2. Actualitzeu la versió canviant el valor `TAG` al fitxer .env prop del vostre docker-compose. (Recomanem utilitzar una versió `major.minor`, com ara `v0.53`)

3. Torneu a posar Twenty en línia amb `docker compose up -d`

Si voleu actualitzar la vostra instància per unes quantes versions, per exemple, de la v0.33.0 a la v0.35.0, heu d'actualitzar la vostra instància de manera seqüencial, en aquest exemple de la v0.33.0 a la v0.34.0, després de la v0.34.0 a la v0.35.0.

**Assegureu-vos que després de cada versió actualitzada teniu una còpia de seguretat sense corrupció.**

## Passos d'actualització específica de la versió

## v1.0

Hola Twenty v1.0! 🎉

## v0.60

### Millores de rendiment

Totes les interaccions amb l'API de metadades s'han optimitzat per a un millor rendiment, especialment per a la manipulació de metadades d'objectes i operacions de creació d'espais de treball.

Hem reformat la nostra estratègia de memòria cau per donar prioritat als resultats de la memòria cau davant les consultes a la base de dades quan sigui possible, millorant significativament el rendiment de les operacions de l'API de metadades.

Si trobeu problemes d'execució després de l'actualització, és possible que hàgiu de buidar la memòria cau per assegurar-vos que estigui sincronitzada amb els canvis més recents. Executeu aquesta comanda al vostre contenidor de twenty-server:

```bash
yarn command:prod cache:flush
```

### v0.55

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.55

Ja no necessiteu executar cap comanda, la nova imatge s'encarregarà automàticament d'executar totes les migracions necessàries.

### Error `User does not have permission`

Si trobeu errors d'autorització en la majoria de sol·licituds després de l'actualització, pot ser que hàgiu de buidar la memòria cau per recalcular els últims permisos.

Al vostre contenidor `twenty-server`, executeu:

```bash
yarn command:prod cache:flush
```

Aquest problema és específic d'aquesta versió de Twenty i no hauria de ser necessari per a actualitzacions futures.

### v0.54

Des de la versió `0.53`, no calen accions manuals.

#### Desactivació de l'esquema de metadades

Hem fusionat l'esquema `metadata` amb el `core` per simplificar la recuperació de dades de `TypeORM`.
Hem fusionat el pas de la comanda `migrate` dins de la comanda `upgrade`. No recomanem executar `migrate` manualment en cap dels vostres contenidors de servidor/treballador.

### Des de la v0.53

A partir de `0.53`, l'actualització es fa programàticament dins del `DockerFile`, això vol dir que a partir d'ara, ja no haureu d'executar cap comanda manualment.

Assegureu-vos de continuar actualitzant la vostra instància seqüencialment, sense saltar cap versió principal (p. ex. `0.43.3` a `0.44.0` està permès, però `0.43.1` a `0.45.0` no ho està), si no, podria provocar una desincronització de la versió de l'espai de treball que podria resultar en errors d'execució i funcionalitat perduda.

Per comprovar si un espai de treball s'ha migrat correctament podeu revisar la seva versió a la base de dades a la taula `core.workspace`.

Sempre ha de ser dins del rang de la versió `major.minor` actual de la vostra instància de Twenty, podeu veure la vostra versió d'instància al panell d'administració (a `/settings/admin-panel`, accessible si el vostre usuari té la propietat `canAccessFullAdminPanel` configurada a true a la base de dades) o executant `echo $APP_VERSION` al vostre contenidor `twenty-server`.

Per solucionar una versió desincronitzada de l'espai de treball, haureu d'actualitzar des de la versió corresponent de Twenty seguint la guia d'actualització relacionada de manera seqüencial fins que arribi a la versió desitjada.

#### Eliminació de `auditLog`

Hem eliminat l'objecte estàndard auditLog, el que significa que la mida de la vostra còpia de seguretat podria reduir-se significativament després d'aquesta migració.

### v0.51 a v0.52

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.52

```
yarn database:migrate:prod
yarn command:prod upgrade
```

#### Tinc un espai de treball bloquejat a la versió entre `0.52.0` i `0.52.6`

Malauradament, `0.52.0` i `0.52.6` han estat completament eliminats de dockerHub.
Haureu d'actualitzar manualment la versió del vostre espai de treball a la `0.51.0` a la base de dades i actualitzar utilitzant la versió de Twenty `0.52.11` seguint just per sobre de la seva guia d'actualització.

### v0.50 a v0.51

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.51

```
yarn database:migrate:prod
yarn command:prod upgrade
```

### v0.44.0 a v0.50.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.50.0

```
yarn database:migrate:prod
yarn command:prod upgrade
```

#### Mutació de Docker-compose.yml

Aquesta versió inclou una mutació de `docker-compose.yml` per donar accés al servei `worker` al volum `server-local-data`.
Si us plau, actualitzeu el vostre `docker-compose.yml` local amb el [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)

### v0.43.0 a v0.44.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.44.0

```
yarn database:migrate:prod
yarn command:prod upgrade
```

### v0.42.0 a v0.43.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.43.0

```
yarn database:migrate:prod
yarn command:prod upgrade
```

En aquesta versió, també hem canviat a la imatge postgres:16 al docker-compose.yml.

#### (Opció 1) Migració de base de dades

Mantenir l'imatge postgres-spilo existent és correcte, però haureu de congelar la versió al vostre docker-compose.yml a 0.43.0.

#### (Opció 2) Migració de base de dades

Si voleu migrar la vostra base de dades a la nova imatge postgres:16, seguiu els passos següents:

1. Descarregueu la vostra base de dades del contenidor antic de postgres-spilo

```
docker exec -it twenty-db-1 sh
pg_dump -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} > databases_backup.sql
exit
docker cp twenty-db-1:/home/postgres/databases_backup.sql .
```

Assegureu-vos que el fitxer de còpia de seguretat no estigui buit.

2. Actualitzeu el vostre docker-compose.yml per utilitzar la imatge postgres:16 tal com es mostra al fitxer [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml).

3. Restaura la base de dades al nou contenidor de postgres:16

```
docker cp databases_backup.sql twenty-db-1:/databases_backup.sql
docker exec -it twenty-db-1 sh
psql -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} -f databases_backup.sql
exit
```

### v0.41.0 a v0.42.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.42.0

```
yarn database:migrate:prod
yarn command:prod upgrade-0.42
```

**Variables d'entorn**

- Eliminat: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
- Afegit: `FRONTEND_URL`, `NODE_PORT`, `MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION`, `MESSAGING_PROVIDER_MICROSOFT_ENABLED`, `CALENDAR_PROVIDER_MICROSOFT_ENABLED`, `IS_MICROSOFT_SYNC_ENABLED`

### v0.40.0 a v0.41.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.41.0

```
yarn database:migrate:prod
yarn command:prod upgrade-0.41
```

**Variables d'entorn**

- Eliminat: `AUTH_MICROSOFT_TENANT_ID`

### v0.35.0 a v0.40.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.40.0

```
yarn database:migrate:prod
yarn command:prod upgrade-0.40
```

**Variables d'entorn**

- Afegit: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`

### v0.34.0 a v0.35.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.35.0

```
yarn database:migrate:prod
yarn command:prod upgrade-0.35
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a l'estructura de la base de dades (esquemes core i metadata)
La comanda `yarn command:prod upgrade-0.35` s'encarrega de la migració de dades de tots els espais de treball.

**Variables d'entorn**

- Hem substituït `ENABLE_DB_MIGRATIONS` per `DISABLE_DB_MIGRATIONS` (el valor per defecte ara és `false`, probablement no haureu de configurar res)

### v0.33.0 a v0.34.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.34.0

```
yarn database:migrate:prod
yarn command:prod upgrade-0.34
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a l'estructura de la base de dades (esquemes core i metadata)
La comanda `yarn command:prod upgrade-0.34` s'encarrega de la migració de dades de tots els espais de treball.

**Variables d'entorn**

- Eliminat: `FRONT_BASE_URL`
- Afegit: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`

Hem actualitzat la manera com gestionem l'URL del frontend.
Ara podeu definir l'URL del frontend utilitzant les variables `FRONT_DOMAIN`, `FRONT_PROTOCOL` i `FRONT_PORT`.
Si no es defineix FRONT_DOMAIN, l'URL del frontend es revertirà a `SERVER_URL`.

### v0.32.0 a v0.33.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.33.0

```
yarn command:prod cache:flush
yarn database:migrate:prod
yarn command:prod upgrade-0.33
```

La comanda `yarn command:prod cache:flush` buidarà la memòria cau de Redis.
La comanda `yarn database:migrate:prod` aplicarà les migracions a l'estructura de la base de dades (esquemes core i metadata)
La comanda `yarn command:prod upgrade-0.33` s'encarrega de la migració de dades de tots els espais de treball.

A partir d'aquesta versió, la imatge de twenty-postgres per a la base de dades es va deprecar i s'utilitza la twenty-postgres-spilo.
Si voleu continuar utilitzant la imatge de twenty-postgres, simplement substituïu `twentycrm/twenty-postgres:${TAG}` per `twentycrm/twenty-postgres` a docker-compose.yml.

### v0.31.0 a v0.32.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.32.0

**Migració d'esquema i dades**

```
yarn database:migrate:prod
yarn command:prod upgrade-0.32
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a l'estructura de la base de dades (esquemes core i metadata)
La comanda `yarn command:prod upgrade-0.32` s'encarrega de la migració de dades de tots els espais de treball.

**Variables d'entorn**

Hem actualitzat la manera com gestionem la connexió de Redis.

- Eliminat: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
- Afegit: `REDIS_URL`

Actualitzeu el vostre fitxer .env per utilitzar la nova variable `REDIS_URL` en lloc dels paràmetres de connexió de Redis individuals.

També hem simplificat la manera en què gestionem els tokens JWT.

- Eliminat: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
- Afegit: `APP_SECRET`

Actualitzeu el vostre fitxer .env per utilitzar la nova variable `APP_SECRET` en lloc dels secrets individuals de tokens (podeu utilitzar el mateix secret que abans o generar un nou cadenat aleatori)

**Compte connectat**

Si esteu utilitzant un compte connectat per sincronitzar els vostres correus electrònics i calendaris de Google, haureu d'activar l'[API de persones](https://developers.google.com/people) al vostre Google Admin console.

### v0.30.0 a v0.31.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.31.0

**Migració d'esquema i dades**:

```
yarn database:migrate:prod
yarn command:prod upgrade-0.31
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a l'estructura de la base de dades (esquemes core i metadata)
La comanda `yarn command:prod upgrade-0.31` s'encarrega de la migració de dades de tots els espais de treball.

### v0.24.0 a v0.30.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.30.0

**Breaking change**:
To enhance performances, Twenty now requires redis cache to be configured. Hem actualitzat el nostre [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) per reflectir això.
Assegureu-vos d'actualitzar la vostra configuració i actualitzar les vostres variables d'entorn en conseqüència:

```
REDIS_HOST={your-redis-host}
REDIS_PORT={your-redis-port}
CACHE_STORAGE_TYPE=redis
```

**Migració d'esquema i dades**:

```
yarn database:migrate:prod
yarn command:prod upgrade-0.30
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a l'estructura de la base de dades (esquemes core i metadata)
La comanda `yarn command:prod upgrade-0.30` s'encarrega de la migració de dades de tots els espais de treball.

### v0.23.0 a v0.24.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.24.0

Executeu les següents comandes:

```
yarn database:migrate:prod
yarn command:prod upgrade-0.24
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a l'estructura de la base de dades (esquemes core i metadata)
La comanda `yarn command:prod upgrade-0.24` s'encarrega de la migració de dades de tots els espais de treball.

### v0.22.0 a v0.23.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.23.0

Executeu les següents comandes:

```
yarn database:migrate:prod
yarn command:prod upgrade-0.23
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a la base de dades.
La comanda `yarn command:prod upgrade-0.23` s'encarrega de la migració de dades, incloent la transferència d'activitats a tasques/notes.

### v0.21.0 a v0.22.0

Actualitzeu la vostra instància de Twenty per utilitzar la imatge v0.22.0

Executeu les següents comandes:

```
yarn database:migrate:prod
yarn command:prod workspace:sync-metadata -f
yarn command:prod upgrade-0.22
```

La comanda `yarn database:migrate:prod` aplicarà les migracions a la base de dades.
La comanda `yarn command:prod workspace:sync-metadata -f` sincronitzarà la definició d'objectes estàndard amb les taules de metadades i aplicarà les migracions necessàries als espais de treball existents.
La comanda `yarn command:prod upgrade-0.22` aplicarà transformacions de dades específiques per adaptar-se a les noves opcions per defecte d'instrumentació de sol·licituds de l'objecte.




