== The basic theory ==

Generally, within a stable release series (e.g. 1.6.0, 1.6.1, etc) there
are no required configuration changes, and upgrading should require no more
than copying the new source files over the old ones.

If there are larger changes, such as upgrading from one release series
to another (e.g. from 1.5.x to 1.6.x), then you may need to update the
configuration.

== IMPORTANT: Upgrading from 1.5.x (or older) ==

Since version 1.6.0, V-webmail used a new configuration system. As there is
no automated upgrade script so far, the configuration has to be migrated
to the new XML-based format manually.

* First, back up your existing V-webmail installation! Make sure that the
  backup is complete; some directories and files may not be readable by
  default.
* Install the new version of V-webmail. See the /manual/V-webmail.pdf
  for details about installing V-webmail. You will need to manually
  migrate the information from the old configuration files (in the config
  directory) to the new local.config.xml file.
* Check if everything works.
* The following (old) configuration files are not needed any more and
  should be removed:
  - local.servers.php
  - local.settings.php
  - local.vhosts.php
  - servers.php
  - settings.php
  - vhosts.php
  

When there are problems upgrading V-webmail and you need some
assistance, then please post your problems in the V-webmail forums
and we will try to assist you.

http://www.v-webmail.org/
http://www.v-webmail.org/forums.html


The V-webmail development team.