# Upgrade SOGo from v4 to v5

SOGo v5 was released on Aug 10, 2020 by the SOGo team (https://sogo.nu), and nightly build packages for v4 and v4 were removed permanently. All users must switch to v5 as soon as possible.

## Upgrade SOGo On RHEL/CentOS

- Backup config files first:

    mkdir -p /root/sogo-backup/{sogo,sysconfig}
    cp /etc/sogo/* /root/sogo-backup/sogo/
    cp /etc/sysconfig/sogo /root/sogo-backup/sysconfig/

- Backup its SQL database:

    bash /var/vmail/backup/backup_*sql.sh
    bash /var/vmail/backup/backup_sogo.sh

- Open file `/etc/yum.repos.d/sogo.repo`, change the version number in `baseurl=` line from `4` to `5`:

    baseurl=https://packages.inverse.ca/SOGo/nightly/5/rhel/$releasever/$basearch/

- SOGo relies on the GNUstep packages provided by SOGo team, and must not use the packages from EPEL repo. Please open file `/etc/yum.repos.d/epel.repo`, make sure you have line like below:

    exclude=gnustep*

- Upgrade SOGo packages:

    yum clean all
    yum update 'sogo*' '*sope*'

- Update config file `/etc/sogo/sogo.conf`, enable TLS without verifying ssl cert.

        SOGoSMTPServer = "smtp://127.0.0.1:587/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
        SOGoMailingMechanism = smtp;
        SOGoSMTPAuthenticationType = PLAIN;

        SOGoSieveServer = "sieve://127.0.0.1:4190/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";

- Restart SOGo and memcached services:

    service memcached restart
    service sogod restart

## Upgrade SOGo On Debian/Ubuntu

- Backup config files first:

    mkdir -p /root/sogo-backup/{sogo,default}
    cp /etc/sogo/* /root/sogo-backup/sogo/
    cp /etc/default/sogo /root/sogo-backup/default/

- Backup its SQL database:

    bash /var/vmail/backup/backup_*sql.sh
    bash /var/vmail/backup/backup_sogo.sh

- Open file `/etc/apt/sources.list` or `/etc/apt/sources.list.d/sogo-nightly.list`, change the version number `4` to `5`, like below:

    # Debian
    https://packages.inverse.ca/SOGo/nightly/5/debian ...

    # Ubuntu
    https://packages.inverse.ca/SOGo/nightly/5/ubuntu ...

- Upgrade SOGo packages:

    apt-get update
    apt-get install --only-upgrade 'sogo*' '*sope*'

- Update config file `/etc/sogo/sogo.conf`, enable TLS without verifying ssl cert.

        SOGoSMTPServer = "smtp://127.0.0.1:587/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";
        SOGoMailingMechanism = smtp;
        SOGoSMTPAuthenticationType = PLAIN;

        SOGoSieveServer = "sieve://127.0.0.1:4190/?tls=YES&tlsVerifyMode=allowInsecureLocalhost";

- Restart SOGo and memcached services:

    service memcached restart
    service sogo restart

## Upgrade SOGo On FreeBSD

FreeBSD ports tree still ships SOGo-4, please wait for v5.

## Upgrade SOGo On OpenBSD

OpenBSD 6.7 still ships SOGo-4, please wait for v5.

## Troubleshooting

If SOGo doesn't work as expected, please check its log file `/var/log/sogo/sogo.log`. If you don't understand what the error message means, please extract related error message and post to our online support forum: https://forum.iredmail.org/.