Skip to content

Commit 62f4f72

Browse files
committed
docs: add guidance about optional services in migration guide
Explicitly mention checking config.php for optional services like Redis, Memcached, and other dependencies before migration. Addresses issue where migrations fail due to missing Redis configuration. Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
1 parent 3add952 commit 62f4f72

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

admin_manual/maintenance/migrating.rst

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,20 @@ the new location. It is also assumed that the authentication method
3737
your original machine was installed recently just copying that base
3838
configuration is a safe best practice.
3939

40+
.. important:: Before beginning the migration, **check the ``config/config.php`` file
41+
on your ORIGINAL system** to identify any optional services that are configured,
42+
such as:
43+
44+
* Redis or Memcached (for caching/sessions)
45+
* External object storage (S3, etc.)
46+
* LDAP
47+
* Mail server settings
48+
* Full-text search backends (Elasticsearch, etc.)
49+
50+
**You must also install and configure these same services on the NEW machine
51+
before copying the Nextcloud files.** Failure to do so may cause errors such
52+
as "Redis server went away" or connection failures during Nextcloud startup.
53+
4054

4155
#. On the original machine then stop Nextcloud. First activate the
4256
maintenance mode. After waiting for 6-7 minutes for all sync clients to

0 commit comments

Comments
 (0)