Upgrade/Migrate trouble-free from Znuny 6.2 to Znuny 6.3

The original documentation to upgrade Znuny 6.2 to latest 6.3 is focused on many different Linux distributions. Here we focus on Ubuntu 20.04 LTS and also with 22.04 LTS

In this article you will find tools and paths how to ensure a clean migration from Znuny 6.2 to Znuny 6.3 under Ubuntu 20.04 and 22.04.

How to get started?

In the article Prepare / start a upgrade / migration of OTRS / Znuny all steps are explained.
Read and execute them carefully to avoid data or e-mail losses!

Doing the migration from Znuny 6.2 to 6.3

The migration is separated into 3 steps.

Migration preparation

Now let us prepare the migration steps.
First you have to check your installed packages in Znuny. In all our tests the autoupgrade of the packages failed, even if this feature shall work from the commit history.
Therefore best way is to note your custom installed packages and to uninstall them. You can later reinstall them easily.
Go to /otrs/index.pl?Action=AdminPackageManager or manually via navigating to Admin > Package Manager
Under Local Repository you will find your installed Packages.

Fetch the migration script

We have provided you the steps as a script to avoid typos or common mistakes.
First we ensure our required packages are installed.

sudo apt install wget findutils git screen

Now fetch the script

cd /opt
git clone https://github.com/itgovernanceportal/otrs-znuny-helpers.git
cd /opt/otrs-znuny-helpers/migrationHelpers/znuny62_2_znuny63

Starting the migration from OTRS to Znuny

Now we can start with the migration itself.


Now run the download znuny and integrate our prior backuped configuration files

sudo ./10_migrationZnuny.sh

Even with big installations 10 million tickets this migration shall only take a few minutes.

    Step 15 of 19: Clean up the cache ...
    Step 16 of 19: Rebuild configuration another time ...
    Step 17 of 19: Deploy ACLs ...
    Step 18 of 19: Deploy processes ...
    Step 19 of 19: Check invalid settings ...

 Migration completed! 

clean caches
Deleting cache...
Deleting all sessions...
upgrading installed packages

There are no installed packages


If you are lucky the migration went through without any issues. If not see the related articles, if some of your issues is already covered there.

Reinstall your packages

Reinstall your packages

Now reinstall your uninstalled packages and you are done with your migration

Related articles

Prepare / start a upgrade / migration of OTRS / Znuny
Upgrade/Migrate trouble-free from OTRS 5 to OTRS/Znuny 6
Upgrade/Migrate trouble-free from Znuny 6.0 to Znuny 6.1
Upgrade/Migrate trouble-free from Znuny 6.1 to Znuny 6.2
Upgrade/Migrate trouble-free from Znuny 6.2 to Znuny 6.3
Upgrade/Migrate trouble-free from Znuny 6.3 to Znuny 6.4
Upgrade/Migrate trouble-free from Znuny 6.4 to Znuny 6.5


Do you need help with Znuny / OTRS?
We have lot of experiences with OTRS and Znuny and can help you with your issues. Get in touch with us and we will check if and how we can help you.

Leave a Comment

Do you need help with Znuny / OTRS?​

We have lot of experiences with OTRS and Znuny.
We can help you with your issues to solve them.

From giving you support up to implementing integrations to your existing systems.

Get in touch with us and we will check if and how we can help you.​

Get OTRS/Znuny/OTOBO Support
Step 1 of 2
To get a quick and efficient clearance of your needs, our experts will call you.
We communicate in English.
Maybe we can communicate in your native language too. So please let us know your native written and spoken language.

Your environment

We have different partners for different tasks and company sizes.
To assign you the right partner and thus the proper system engineers, we would like to ask you for more details about your environment.
The more details we get the quicker we can narrow down to the right persons.