[comment]: # translation:outdated

[comment]: # ({new-e1f5ce3f})
# Upgrade from containers

[comment]: # ({/new-e1f5ce3f})

[comment]: # ({new-236aea13})
### Overview

This section describes steps required for a successful
[upgrade](/manual/installation/upgrade) from Zabbix **6.2**.x containers to Zabbix
**6.4**.x containers.

Separate sets of instructions are available for upgrading individual Zabbix component [images](#Zabbix-image-uprade) and Docker [compose files](#compose-files).

::: notewarning
Before the upgrade make sure to read the relevant
[**upgrade notes**](/manual/installation/upgrade)!
:::

::: noteimportant
Before starting the upgrade, verify that users have the necessary permissions to the database for upgrading purposes.   

For upgrades from Zabbix 6.0 or older, 
deterministic triggers will need to be created during the upgrade. If binary logging is enabled for MySQL/MariaDB, this requires superuser privileges or setting the variable/configuration parameter  *log_bin_trust_function_creators = 1*. See [Database creation scripts](/manual/appendix/install/db_scripts#mysql) for instructions how to set the variable.
:::

Depending on the size of a database upgrade to version 6.4 may take
quite a long time.

[comment]: # ({/new-236aea13})

[comment]: # ({new-27011b38})

### Zabbix image upgrade

The steps listed below can be used to upgrade any Zabbix component. Replace  `zabbix-server-mysql` with the required component image name.

\1. Check current image version:

    docker inspect -f '{{ .Config.Image }}' zabbix-server-mysql

\2. Pull desired image version, for example:

    docker pull zabbix/zabbix-server-mysql:alpine-6.4-latest

`zabbix/zabbix-server-mysql:alpine-6.4-latest` will pull the latest released minor version of Zabbix server 
6.4 with MySQL support based on Alpine Linux.  Replace it with the name of the Docker repository 
and tags combination you need. See [Installation from containers](/manual/installation/containers#docker) for a list of available options. 

\3. Stop the container:
    
    docker stop zabbix-server-mysql

\4. Remove the container:

    docker rm zabbix-server-mysql
    
\5. Launch the updated container by executing `docker run` command followed by additional arguments 
to specify required [environment variables](/manual/installation/containers#environment-variables) 
and/or [mount points](/manual/installation/containers#volumes).

**Configuration examples**

Zabbix server with MySQL:

    docker run --name zabbix-server-mysql -t \
          -e DB_SERVER_HOST="mysql-server" \
          -e MYSQL_DATABASE="zabbix" \
          -e MYSQL_USER="zabbix" \
          -e MYSQL_PASSWORD="zabbix_pwd" \
          -e MYSQL_ROOT_PASSWORD="root_pwd" \
          -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \
          --network=zabbix-net \
          -p 10051:10051 \
          --restart unless-stopped \
          -d zabbix/zabbix-server-mysql:alpine-6.4-latest

Zabbix server with PostgreSQL:

    docker run --name zabbix-server-mysql -t \
             -e DB_SERVER_HOST="postgres-server" \
             -e POSTGRES_USER="zabbix" \
             -e POSTGRES_PASSWORD="zabbix_pwd" \
             -e POSTGRES_DB="zabbix" \
             -e ZBX_ENABLE_SNMP_TRAPS="true" \
             --network=zabbix-net \
             -p 10051:10051 \
             --volumes-from zabbix-snmptraps \
             --restart unless-stopped \
             -d zabbix/zabbix-server-pgsql:alpine-6.4-latest

More configuration examples, including examples for other Zabbix components, 
are available on the [Installation from containers](/manual/installation/containers#examples) page.
 
6. Verify the update:

    docker logs -f zabbix-server-mysql

[comment]: # ({/new-27011b38})

[comment]: # ({new-d707ad1d})

### Compose files

Follow upgrade instructions in this section, if you installed Zabbix 
using [compose file](/manual/installation/containers#docker-compose). 

\1. Check current image version:

    docker inspect -f '{{ .Config.Image }}' zabbix-server-mysql

\2. Pull the latest updates from the GitHub [repository](https://github.com/zabbix/zabbix-docker) and switch to the required branch:

    git pull
    git checkout 6.4

\3. Start Zabbix components using new compose file:

    docker-compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d

\4. Verify the update:

    docker logs -f zabbix-server-mysql

See [Installation from containers](/manual/installation/containers#docker-compose) for more details, including lists of supported environment variables and volume mount points. 

[comment]: # ({/new-d707ad1d})