---
title: Guia de Atualização
image: /images/user-guide/notes/notes_header.png
---

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

## Diretrizes gerais

**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}`.

Se você usou Docker Compose, siga estes passos:

1. Em um terminal, no host onde Twenty está sendo executado, desligue o Twenty: `docker compose down`

2. Atualize a versão alterando o valor `TAG` no arquivo .env próximo ao seu docker-compose. ( Recomendamos consumir a versão `major.minor`, como `v0.53` )

3. Reative o Twenty com `docker compose up -d`

Se você deseja atualizar sua instância por algumas versões, por exemplo, de v0.33.0 para v0.35.0, você deve atualizar sua instância sequencialmente, neste exemplo de v0.33.0 para v0.34.0, depois de v0.34.0 para v0.35.0.

**Certifique-se de que após cada versão atualizada você tenha um backup não corrompido.**

## Passos de atualização específicos da versão

## v1.0

Olá Twenty v1.0! 🎉

## v0.60

### Melhorias de Desempenho

Todas as interações com a API de metadados foram otimizadas para melhor desempenho, particularmente para manipulação de metadados de objeto e operações de criação de espaço de trabalho.

Refatoramos nossa estratégia de cache para priorizar acertos de cache sobre consultas de banco de dados sempre que possível, melhorando significativamente o desempenho das operações da API de metadados.

Se você encontrar problemas de tempo de execução após a atualização, pode ser necessário limpar seu cache para garantir que esteja sincronizado com as alterações mais recentes. Execute este comando no seu contêiner do servidor Twenty:

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

### v0.55

Atualize sua instância Twenty para usar a imagem v0.55

Você não precisa mais executar nenhum comando, a nova imagem cuidará automaticamente de executar todas as migrações necessárias.

### Erro `Usuário não tem permissão`

Se você encontrar erros de autorização na maioria das solicitações após a atualização, pode ser necessário limpar seu cache para recalcular as permissões mais recentes.

No seu contêiner `twenty-server`, execute:

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

Este problema é específico desta versão do Twenty e não deve ser necessário para futuras atualizações.

### v0.54

Desde a versão `0.53`, nenhuma ação manual é necessária.

#### Descontinuação do esquema de metadados

Mesclamos o esquema `metadata` no esquema `core` para simplificar a recuperação de dados do `TypeORM`.
Mesclamos o passo do comando `migrate` dentro do comando `upgrade`. Não recomendamos executar `migrate` manualmente em nenhum de seus contêineres de servidor/trabalhadores.

### Desde v0.53

A partir da versão `0.53`, a atualização é realizada programaticamente dentro do `DockerFile`, o que significa que a partir de agora, você não precisará mais executar comandos manualmente.

Certifique-se de continuar atualizando sua instância sequencialmente, sem pular nenhuma versão principal (por exemplo, `0.43.3` para `0.44.0` é permitido, mas `0.43.1` para `0.45.0` não é), caso contrário, pode levar a uma dessincronização da versão do espaço de trabalho que pode resultar em erro de tempo de execução e funcionalidade ausente.

Para verificar se um espaço de trabalho foi migrado corretamente, você pode revisar sua versão no banco de dados na tabela `core.workspace`.

Ela deve estar sempre no alcance da versão `major.minor` da sua instância atual do Twenty, você pode visualizar a versão da sua instância no painel de administração (em `/settings/admin-panel`, acessível se sua propriedade de usuário tiver `canAccessFullAdminPanel` definida como verdadeira no banco de dados) ou executando `echo $APP_VERSION` no seu contêiner `twenty-server`.

Para corrigir uma versão de espaço de trabalho dessincronizada, você terá que atualizar a partir da versão correspondente do Twenty seguindo o guia de atualização relacionado sequencialmente e assim por diante até atingir a versão desejada.

#### `auditLog` removal

Removemos o objeto padrão auditLog, o que significa que o tamanho do backup pode ser significativamente reduzido após esta migração.

### v0.51 para v0.52

Atualize sua instância Twenty para usar a imagem v0.52

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

#### Eu tenho um espaço de trabalho bloqueado na versão entre `0.52.0` e `0.52.6`

Infelizmente `0.52.0` e `0.52.6` foram completamente removidos do dockerHub.
Você terá que atualizar manualmente a versão do seu espaço de trabalho para `0.51.0` no banco de dados e atualizar usando a versão twenty `0.52.11` seguindo seu guia de atualização logo acima.

### v0.50 para v0.51

Atualize sua instância Twenty para usar a imagem v0.51

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

### v0.44.0 para v0.50.0

Atualize sua instância Twenty para usar a imagem v0.50.0

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

#### Mutação do Docker-compose.yml

Esta versão inclui uma mutação `docker-compose.yml` para dar ao serviço `worker` acesso ao volume `server-local-data`.
Por favor, atualize seu `docker-compose.yml` local com [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)

### v0.43.0 para v0.44.0

Atualize sua instância Twenty para usar a imagem v0.44.0

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

### v0.42.0 para v0.43.0

Atualize sua instância Twenty para usar a imagem v0.43.0

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

Nesta versão, também mudamos para a imagem postgres:16 no docker-compose.yml.

#### (Opção 1) Migração de Banco de Dados

Manter a imagem postgres-spilo existente está bem, mas você terá que congelar a versão no seu docker-compose.yml para ser 0.43.0.

#### (Opção 2) Migração de Banco de Dados

Se você deseja migrar seu banco de dados para a nova imagem postgres:16, siga estas etapas:

1. Faça dump do seu banco de dados do contêiner antigo 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 .
```

Certifique-se de que seu arquivo de backup não esteja vazio.

2. Atualize seu docker-compose.yml para usar a imagem postgres:16 como no arquivo [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml).

3. Restaure o banco de dados para o novo contêiner 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 para v0.42.0

Atualize sua instância Twenty para usar a imagem v0.42.0

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

**Variáveis de Ambiente**

- Removido: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
- Adicionado: `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 para v0.41.0

Atualize sua instância Twenty para usar a imagem v0.41.0

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

**Variáveis de Ambiente**

- Removido: `AUTH_MICROSOFT_TENANT_ID`

### v0.35.0 para v0.40.0

Atualize sua instância Twenty para usar a imagem v0.40.0

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

**Variáveis de Ambiente**

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

### v0.34.0 para v0.35.0

Atualize sua instância Twenty para usar a imagem v0.35.0

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

O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados)
O `yarn command:prod upgrade-0.35` cuida da migração de dados de todos os espaços de trabalho.

**Variáveis de Ambiente**

- Substituímos `ENABLE_DB_MIGRATIONS` por `DISABLE_DB_MIGRATIONS` (o valor padrão agora é `false`, você provavelmente não precisa definir nada)

### v0.33.0 para v0.34.0

Atualize sua instância Twenty para usar a imagem v0.34.0

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

O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados)
O `yarn command:prod upgrade-0.34` cuida da migração de dados de todos os espaços de trabalho.

**Variáveis de Ambiente**

- Removido: `FRONT_BASE_URL`
- Adicionado: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`

Atualizamos a maneira como lidamos com o URL do frontend.
Agora você pode definir o URL do frontend usando as variáveis `FRONT_DOMAIN`, `FRONT_PROTOCOL` e `FRONT_PORT`.
Se FRONT_DOMAIN não estiver definido, o URL do frontend será revertido para `SERVER_URL`.

### v0.32.0 para v0.33.0

Atualize sua instância Twenty para usar a imagem v0.33.0

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

O comando `yarn command:prod cache:flush` irá limpar o cache do Redis.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados)
O `yarn command:prod upgrade-0.33` cuida da migração de dados de todos os espaços de trabalho.

A partir desta versão, a imagem twenty-postgres para DB tornou-se obsoleta e twenty-postgres-spilo é usado em seu lugar.
Se desejar continuar usando a imagem twenty-postgres, basta substituir `twentycrm/twenty-postgres:${TAG}` por `twentycrm/twenty-postgres` no docker-compose.yml.

### v0.31.0 para v0.32.0

Atualize sua instância Twenty para usar a imagem v0.32.0

**Migração de esquema e dados**

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

O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados)
O `yarn command:prod upgrade-0.32` cuida da migração de dados de todos os espaços de trabalho.

**Variáveis de Ambiente**

Atualizamos a maneira como lidamos com a conexão Redis.

- Removido: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
- Adicionado: `REDIS_URL`

Atualize o seu arquivo `.env` para usar a nova variável `REDIS_URL` em vez dos parâmetros individuais de conexão Redis.

Também simplificamos a maneira como lidamos com os tokens JWT.

- Removido: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
- Adicionado: `APP_SECRET`

Atualize o seu arquivo `.env` para usar a nova variável `APP_SECRET` em vez dos segredos individuais de tokens (você pode usar o mesmo segredo de antes ou gerar uma nova string aleatória)

**Conta Conectada**

Se você estiver usando uma conta conectada para sincronizar seus e-mails e calendários do Google, será necessário ativar a [People API](https://developers.google.com/people) no seu console do Google Admin.

### v0.30.0 para v0.31.0

Atualize sua instância Twenty para usar a imagem v0.31.0

**Migração de esquema e dados**:

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

O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados)
O `yarn command:prod upgrade-0.31` cuida da migração de dados de todos os espaços de trabalho.

### v0.24.0 para v0.30.0

Atualize sua instância Twenty para usar a imagem v0.30.0

**Breaking change**:
To enhance performances, Twenty now requires redis cache to be configured. Atualizamos nosso [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) para refletir isso.
Certifique-se de atualizar sua configuração e de atualizar suas variáveis de ambiente de acordo:

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

**Migração de esquema e dados**:

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

O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados)
O `yarn command:prod upgrade-0.30` cuida da migração de dados de todos os espaços de trabalho.

### v0.23.0 para v0.24.0

Atualize sua instância Twenty para usar a imagem v0.24.0

Execute os seguintes comandos:

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

O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas centrais e de metadados)
O `yarn command:prod upgrade-0.24` cuida da migração de dados de todos os espaços de trabalho.

### v0.22.0 para v0.23.0

Atualize sua instância Twenty para usar a imagem v0.23.0

Execute os seguintes comandos:

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

O comando `yarn database:migrate:prod` aplicará as migrações ao Banco de Dados.
O `yarn command:prod upgrade-0.23` cuida da migração de dados, incluindo transferir atividades para tarefas/notas.

### v0.21.0 para v0.22.0

Atualize sua instância Twenty para usar a imagem v0.22.0

Execute os seguintes comandos:

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

O comando `yarn database:migrate:prod` aplicará as migrações ao Banco de Dados.
O comando `yarn command:prod workspace:sync-metadata -f` sincronizará a definição de objetos padrão com as tabelas de metadados e aplicará as migrações necessárias aos workspaces existentes.
O comando `yarn command:prod upgrade-0.22` aplicará transformações específicas de dados para adaptar-se às novas `object defaultRequestInstrumentationOptions`.




