diff options
authorMichał Górny <>2018-04-08 11:15:16 +0200
committerMichał Górny <>2018-04-08 11:15:26 +0200
commit7ecf72b7445ad7cd0c9a875b4607f282b140fccd (patch)
parent2018-03-13-portage-rsync-verification-unstable: Add (diff)
2018-04-08-radicale-2-requires-pre-install-migration: New item
1 files changed, 26 insertions, 0 deletions
diff --git a/2018-04-08-radicale-2-requires-pre-install-migration/2018-04-08-radicale-2-requires-pre-install-migration.en.txt b/2018-04-08-radicale-2-requires-pre-install-migration/2018-04-08-radicale-2-requires-pre-install-migration.en.txt
new file mode 100644
index 0000000..8783ee8
--- /dev/null
+++ b/2018-04-08-radicale-2-requires-pre-install-migration/2018-04-08-radicale-2-requires-pre-install-migration.en.txt
@@ -0,0 +1,26 @@
+Title: Radicale 2 requires pre-install migration
+Author: Christopher Head <>
+Posted: 2018-04-02
+Revision: 1
+News-Item-Format: 2.0
+Display-If-Installed: <www-apps/radicale-2
+Radicale version 2 uses a new storage format and is not able to read
+databases created by version 1. Version 1 releases starting from 1.1.3
+include a --export-storage option which can be used to export their
+databases in a format that Radicale 2 can use; you must do this before
+upgrading to version 2.
+If you have kept the Gentoo-default database configuration, this will
+1. Stop any running instance of Radicale.
+2. Run `radicale --export-storage ~/radicale-exported`.
+3. Run `chown -R radicale: ~/radicale-exported`
+4. Run `mv /var/lib/radicale /var/lib/radicale.old`.
+5. Install Radicale version 2.
+6. Run `mv ~/radicale-exported /var/lib/radicale/collections`.
+For more details, or if you are have a more complex configuration,
+please see the migration guide:
+If you do a custom migration, please ensure the database is cleaned out
+of /var/lib/radicale, including the hidden .props file.