---
title: Päivitysopas
image: /images/user-guide/notes/notes_header.png
---

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

## Yleiset ohjeet

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

Jos käytit Docker Composea, noudata näitä ohjeita:

1. Päätelaitteessa, jossa Twenty on käynnissä, sammuta Twenty: `docker compose down`

2. Päivitä versio muuttamalla `TAG` -arvoa .env-tiedostossa lähellä docker-composea. ( Suosittelemme käyttämään version `major.minor` muotoa, kuten `v0.53` )

3. Käynnistä Twenty uudelleen käyttämällä `docker compose up -d`

Jos haluat päivittää useamman version kerralla, esimerkiksi v0.33.0:sta v0.35.0:aan, sinun on päivitettävä vaiheittain, tässä esimerkissä v0.33.0:sta v0.34.0:aan ja sitten v0.34.0:sta v0.35.0:aan.

**Varmista, että jokaisen päivityksen jälkeen varmuuskopio on ehjä.**

## Versiokohtaiset päivitysaskeleet

## v1.0

Tervetuloa Twenty versioon v1.0! 🎉

## v0.60

### Suorituskyvyn parannukset

Kaikki vuorovaikutukset metadata API:n kanssa on optimoitu paremman suorituskyvyn saavuttamiseksi, erityisesti kohdemetadatan käsittelyssä ja työtilojen luontitoiminnoissa.

Olemme uudistaneet välimuististrategiamme niin, että etusijalle asetetaan välimuistin osumat tietokantakyselyiden sijaan aina kun mahdollista, mikä parantaa merkittävästi metadata API:n suorituskykyä.

Jos kohtaat suoritusongelmia päivityksen jälkeen, saatat joutua tyhjentämään välimuistisi varmistaaksesi sen synkronoinnin uusimpien muutosten kanssa. Suorita tämä komento twenty-server-säilössäsi:

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

### v0.55

Päivitä Twenty-asennuksesi käyttämään v0.55-kuvaa

Sinun ei tarvitse enää suorittaa mitään komentoja, uusi kuva huolehtii automaattisesti kaikista tarvittavista migraatioista.

### `Käyttäjällä ei ole oikeuksia` -virhe

Jos kohtaat valtuutusvirheitä useimmissa pyynnöissä päivityksen jälkeen, sinun saattaa olla tarpeen tyhjentää välimuistisi laskeaksesi uusimmat oikeudet uudelleen.

Suorita seuraava komento `twenty-server`-säilössäsi:

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

Tämä ongelma koskee vain tätä Twenty-versiota eikä pitäisi olla tarpeen jatkossa.

### v0.54

Versiosta `0.53` eteenpäin ei vaadita manuaalisia toimia.

#### Metadataskeeman vanhentuminen

Olemme yhdistäneet `metadata`-skeeman ja `core`-skeeman yksinkertaistaaksemme datan hakua `TypeORM`:stä.
Olemme yhdistäneet `migrate`-komennon vaiheet `upgrade`-komennon sisälle. Emme suosittele `migrate`:n ajamista manuaalisesti missään palvelin- tai työntekijäsäilöissäsi.

### Versiosta v0.53 alkaen

Starting from `0.53`, upgrade is programmatically done within the `DockerFile`, this means from now on, you shouldn't have to run any command manually anymore.

Varmista, että päivität asennuksesi vaiheittain, ilman että sivuutat merkittäviä versioita (esim. `0.43.3` versioon `0.44.0` on sallittua, mutta ei `0.43.1` versioon `0.45.0`), muuten se voi johtaa työtilan version epäyhtenäisyyksiin, mikä voi aiheuttaa suoritusvirheitä ja puuttuvaa toiminnallisuutta.

Voit tarkistaa, onko työtila päivitetty oikein tarkistamalla sen version tietokannasta `core.workspace`-taulussa.

Sen tulisi aina olla nykyisen Twentyn asennusversion `major.minor`-välillä, voit tarkistaa asennusversion hallintapaneelista (osoitteessa `/settings/admin-panel`, saavutettavissa jos käyttäjälläsi on `canAccessFullAdminPanel`-omaisuus määritetty arvoksi true tietokannassa) tai suorittamalla komento `echo $APP_VERSION` `twenty-server`-säilössäsi.

Voit ratkaista epäyhtenäisen työtilan version päivittämällä vastaavasta Twentyn versiosta liittyvän päivitysoppaan ohjeiden mukaisesti vaiheittain, kunnes saavutat toivotun version.

#### `auditLog`-poisto

Olemme poistaneet auditLog-standardiobjektin, mikä voi pienentää varmuuskopion kokoa merkittävästi tämän migraation jälkeen.

### v0.51:stä v0.52:een

Päivitä Twenty-asennuksesi käyttämään v0.52-kuvaa

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

#### Minulla on työtila, joka on juuttunut välillä versioiden `0.52.0` ja `0.52.6` väliin

Valitettavasti versiot `0.52.0` ja `0.52.6` on poistettu täysin dockerHubista.
Sinun on päivitettävä työtilan versioksi `0.51.0` tietokantaan käsin ja päivitettävä Twenty-versiolla `0.52.11` seuraamalla sen yläpuolella annettua päivitysopasta.

### v0.50:stä v0.51:een

Päivitä Twenty-asennuksesi käyttämään v0.51-kuvaa

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

### v0.44.0:sta v0.50.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.50.0-kuvaa

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

#### Docker-compose.yml:in muutos

Tämä versio sisältää `docker-compose.yml`-tiedoston muutoksen, jolla `worker`-palvelulle annetaan pääsy `server-local-data`-volyymiin.
Päivitä paikallinen `docker-compose.yml` [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml) avulla

### v0.43.0:sta v0.44.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.44.0-kuvaa

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

### v0.42.0:sta v0.43.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.43.0-kuvaa

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

Tässä versiossa olemme siirtyneet postgres:16-kuvaan docker-compose.yml:ssä.

#### (Vaihtoehto 1) Tietokannan migraatio

Pidetään olemassa oleva postgres-spilo-kuva, mutta sinun on jäädytettävä versio docker-compose.yml:ssä versioksi 0.43.0.

#### (Vaihtoehto 2) Tietokannan migraatio

Jos haluat siirtää tietokantasi uuteen postgres:16-kuvaan, noudata seuraavia vaiheita:

1. Vie tietokanta vanhasta postgres-spilo-säilöstä

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

Varmista, että dump-tiedostosi ei ole tyhjä.

2. Päivitä docker-compose.yml käyttämään postgres:16-kuvaa, kuten [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) -tiedostossa on.

3. Palauta tietokanta uuteen postgres:16-säilöön

```
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:stä v0.42.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.42.0-kuvaa

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

**Ympäristömuuttujat**

- Poistettu: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
- Lisätty: `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:sta v0.41.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.41.0-kuvaa

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

**Ympäristömuuttujat**

- Poistettu: `AUTH_MICROSOFT_TENANT_ID`

### v0.35.0:sta v0.40.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.40.0-kuvaa

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

**Ympäristömuuttujat**

- Lisätty: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`

### v0.34.0:sta v0.35.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.35.0-kuvaa

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
Komento `yarn command:prod upgrade-0.35` huolehtii kaikkien työtilojen datamigraatioista.

**Ympäristömuuttujat**

- Olemme korvanneet `ENABLE_DB_MIGRATIONS` `DISABLE_DB_MIGRATIONS`-muuttujalla (oletusarvo on nyt `false`, luultavasti sinun ei tarvitse asettaa mitään)

### v0.33.0:sta v0.34.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.34.0-kuvaa

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
Komento `yarn command:prod upgrade-0.34` huolehtii kaikkien työtilojen datamigraatioista.

**Ympäristömuuttujat**

- Poistettu: `FRONT_BASE_URL`
- Lisätty: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`

Olemme päivittäneet etuosan URL-osoitteen käsittelytavan.
Voit nyt asettaa etuosan URL-osoitteen käyttämällä muuttujia `FRONT_DOMAIN`, `FRONT_PROTOCOL` ja `FRONT_PORT`.
Jos FRONT_DOMAIN ei ole asetettu, etuosan URL-osoite palautuu `SERVER_URL`:ään.

### v0.32.0:stä v0.33.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.33.0-kuvaa

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

Komento `yarn command:prod cache:flush` tyhjentää Redis-välimuistin.
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
Komento `yarn command:prod upgrade-0.33` huolehtii kaikkien työtilojen datamigraatioista.

Starting from this version, twenty-postgres image for DB became deprecated and twenty-postgres-spilo is used instead.
If you want to keep using twenty-postgres image, simply replace `twentycrm/twenty-postgres:${TAG}` with `twentycrm/twenty-postgres` in docker-compose.yml.

### v0.31.0:stä v0.32.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.32.0-kuvaa

**Skeeman ja datan migraatio**

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
Komento `yarn command:prod upgrade-0.32` huolehtii kaikkien työtilojen datamigraatioista.

**Ympäristömuuttujat**

We have updated the way we handle the Redis connection.

- Poistettu: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
- Lisätty: `REDIS_URL`

Päivitä `.env`-tiedostosi käyttämään uutta `REDIS_URL`-muuttujaa yksittäisten Rediksen yhteysparametrien sijasta.

Olemme myös yksinkertaistaneet tapaamme käsitellä JWT-tokeneita.

- Poistettu: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
- Lisätty: `APP_SECRET`

Päivitä `.env`-tiedostosi käyttämään uutta `APP_SECRET`-muuttujaa yksittäisten tokeneiden salasanojen sijasta (voit käyttää samaa salasanaa kuin aiemmin tai luoda uuden satunnaisen merkkijonon)

**Liitetty tili**

Jos käytät yhdistettyjä tilejä Google-sähköpostisi ja kalenteriesi synkronoimiseen, sinun on aktivoitava [People API](https://developers.google.com/people) Google-hallintakeskuksessasi.

### v0.30.0:sta v0.31.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.31.0-kuvaa

**Skeeman ja datan migraatio**:

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
Komento `yarn command:prod upgrade-0.31` huolehtii kaikkien työtilojen datamigraatioista.

### v0.24.0:sta v0.30.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.30.0-kuvaa

**Breaking change**:
To enhance performances, Twenty now requires redis cache to be configured. Olemme päivittäneet [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) heijastamaan tätä.
Varmista, että päivität konfiguraatiosi ja ympäristömuuttujasi vastaavasti:

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

**Skeeman ja datan migraatio**:

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
Komento `yarn command:prod upgrade-0.30` huolehtii kaikkien työtilojen datamigraatioista.

### v0.23.0:sta v0.24.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.24.0-kuvaa

Suorita seuraavat komennot:

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
Komento `yarn command:prod upgrade-0.24` huolehtii kaikkien työtilojen datamigraatioista.

### v0.22.0:sta v0.23.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.23.0-kuvaa

Suorita seuraavat komennot:

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokantaan.
Komento `yarn command:prod upgrade-0.23` huolehtii datamigraatioista, mukaan lukien aktiviteettien siirtäminen tehtäviin/muistiinpanoihin.

### v0.21.0:sta v0.22.0:aan

Päivitä Twenty-asennuksesi käyttämään v0.22.0-kuvaa

Suorita seuraavat komennot:

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

Komento `yarn database:migrate:prod` soveltaa migraatiot tietokantaan.
The `yarn command:prod workspace:sync-metadata -f` command will sync the definition of standard objects to the metadata tables and apply to required migrations to existing workspaces.
The `yarn command:prod upgrade-0.22` command will apply specific data transformations to adapt to the new object defaultRequestInstrumentationOptions.




