6.0.0-git
2024-04-25
Last Modified 2022-11-03 by Ralf Lang

Upgrade from Horde 5 / PEAR

Horde 5 is supposed to run on PHP 5.x - 7.4 and Horde 6 is supposed to run on PHP 7.4 - 8.x.
Also, the filesystem structure of Horde 6 is different. It is recommended NOT to run an inplace upgrade but backup all assets and start

Prerequisites

- Copy existing installation's database to a new database. At the end of the installation the schema will be changed and no longer fit for Horde 5.
- Go to all Horde 5 apps, including horde base, and safe files like
- registry.local.php
- conf.php
- prefs.local.php
- hooks.php
- attributes.local.php
- backends.local.php
- basically *.local.php
- registry.d/*

You normally don't need to keep these:
- conf.xml
- prefs.php
- backends.php
- attributes.php

These come with the code.
Modifying these was not advisable even in horde 5.

Web Server Config

The Web server's webroot needs to point to the /web subdirectory of the root project, not the top directory of the root project.
See fresh install docs for more detail.

Setup a root project

git clone https://github.com/maintaina-com/horde-deployment.git

Copy Horde configs

Mind the different structure:

old: horde/config/conf.php
new: var/config/horde/conf.php
old: horde/config/*.local.php
new: var/config/horde/
old: horde/config/registry.d
new: var/config/horde/registry.d/

old: horde/nag/conf.php
new: var/config/nag/conf.php
old: horde/nag/config/*.local.php
new: var/config/nag/*.local.php

etc

Editing registry

If your registry.local.php or registry.d/ snippet contains hardcoded webroot or fileroot, comment out these lines.

Install Horde 6

Install the base app

composer install

Install additional apps

composer require horde/kronolith ^5
composer require horde/turba ^5
composer require horde/passwd ^6
composer require horde/mnemo ^5
composer require horde/content ^3
composer require horde/timeobjects ^3
composer require horde/imp ^7

etc ... see the installing chapter for more details on this step.

Upgrade the database

./vendor/bin/horde-db-migrate up

Check the Web UI for configs that need upgrading

Goto the horde/admin/config screen. Check for all apps if there are new settings which need configuration.