diff --git a/doc/settings/configuration.md b/doc/settings/configuration.md
index 715e27bc7a08791845d9f7c2b951aa64f79b85ea_ZG9jL3NldHRpbmdzL2NvbmZpZ3VyYXRpb24ubWQ=..bdd3424221106ec29c79391ff43b2538568d752a_ZG9jL3NldHRpbmdzL2NvbmZpZ3VyYXRpb24ubWQ= 100644
--- a/doc/settings/configuration.md
+++ b/doc/settings/configuration.md
@@ -290,6 +290,15 @@
 
 Run `sudo gitlab-ctl reconfigure` for the changes to take effect.
 
+If you're changing `user['uid']` and `user['gid']`, you should make sure to update the uid/guid of any files not managed by Omnibus directly, for example logs:
+
+```shell
+find /var/log/gitlab -uid <old_uid> | xargs -I:: chown git ::
+find /var/log/gitlab -gid <old_uid> | xargs -I:: chgrp git ::
+find /var/opt/gitlab -uid <old_uid> | xargs -I:: chown git ::
+find /var/opt/gitlab -gid <old_uid> | xargs -I:: chgrp git ::
+```
+
 ## Disable user and group account management
 
 By default, Omnibus GitLab takes care of creating system user and group accounts