diff --git a/doc/administration/gitaly/recovery.md b/doc/administration/gitaly/recovery.md
index dbbed0f60ba08debec2d3f1bdf7d2493a1fbda5a..980b4c89145c868066f672b7dc062376bacb15a9 100644
--- a/doc/administration/gitaly/recovery.md
+++ b/doc/administration/gitaly/recovery.md
@@ -432,6 +432,10 @@ sudo /opt/gitlab/embedded/bin/praefect -config /var/opt/gitlab/praefect/config.t
 > - [Introduced](https://gitlab.com/gitlab-org/omnibus-gitlab/-/merge_requests/5658) in GitLab 14.4.
 > - [Introduced](https://gitlab.com/gitlab-org/omnibus-gitlab/-/merge_requests/5789) in GitLab 14.6, support for immediate replication.
 
+WARNING:
+Manually adding repositories to the tracking database is broken with Praefect-generated replica paths (`@cluster`).
+The repository is not given the correct relative repository path.
+
 The `track-repository` Praefect sub-command adds repositories on disk to the Praefect tracking database to be tracked.
 
 ```shell
@@ -484,6 +488,10 @@ This command fails if:
 
 > [Introduced](https://gitlab.com/gitlab-org/omnibus-gitlab/-/merge_requests/6319) in GitLab 15.4.
 
+WARNING:
+Manually adding repositories to the tracking database is broken with Praefect-generated replica paths (`@cluster`).
+The repository is not given the correct relative repository path.
+
 Migrations using the API automatically add repositories to the Praefect tracking database.
 
 If you are instead manually copying repositories over from existing infrastructure, you can use the `track-repositories`