1 files changed, 35 insertions, 0 deletions
diff --git a/doc/wiki/Upgrading.2.1.txt b/doc/wiki/Upgrading.2.1.txt
new file mode 100644
index 0000000..0dec9ff
--- /dev/null
+++ b/doc/wiki/Upgrading.2.1.txt
@@ -0,0 +1,35 @@
+Upgrading Dovecot v2.0 to v2.1
+==============================
+
+v2.1 is mostly compatible with v2.0 configuration, except:
+
+ * 15-mailboxes.conf included in the default configuration now specifies a few
+   default SPECIAL-USE [http://tools.ietf.org/html/rfc6154] mailboxes. This
+   file assumes that you already have 'namespace inbox { .. } ' specified (in
+   10-mail.conf). If you don't, you'll get errors about namespaces. Note that
+   the namespace's name must be "inbox" (as well as usually include inbox=yes
+   setting). The solution is to either make sure that you have such a namespace
+   defined, or you can simply delete the 15-mailboxes.conf if you don't care
+   about SPECIAL-USE.
+ * <Plugins.txt> now use UTF-8 mailbox names rather than mUTF-7: acl,
+   autocreate, expire, trash, virtual
+ * Usernames in authentication are now lowercased by default.
+    * Non-lowercase usernames in password/user database result in "unknown
+      user" errors
+    * To allow mixed case usernames again, set 'auth_username_format=' (i.e. to
+      empty)
+ * <Solr> [Plugins.FTS.Solr.txt] full text search backend changed to use
+   mailbox GUIDs instead of mailbox names, requiring reindexing everything.
+   solr_old backend can be used with old indexes to avoid reindexing, but it
+   doesn't support some newer features.
+ * <Expire plugin> [Plugins.Expire.txt]: Only go through users listed by userdb
+   iteration. Delete dict rows for nonexistent users, unless
+   expire_keep_nonexistent_users=yes.
+ * <dsync> [Tools.Dsync.txt] was merged into doveadm. There is still "dsync"
+   symlink pointing to "doveadm", which you can use the old way for now. The
+   preferred ways to run dsync are "doveadm sync" (for old "dsync mirror") and
+   "doveadm backup".
+ * dsync protocol isn't compatible with v2.0's dsync, so you can't dsync
+   between v2.0 and v2.1 servers.
+
+(This file was created from the wiki on 2019-06-19 12:42)