nextcloud / nextcloud/documentation

Clarification for LDAP user cleanup

Open
#13,868 1 comment 1 reaction 1 assignee View on GitHub

@joshtrichards is already working on this.

Since Nov 28, 2025.

1. to develop enhancement feature: ldap manual: admin
Dominant language
JavaScript
Stars
628
Forks
2.5k
Avg merge
2d 11h
Merged PRs (30d)
135

Description

Before You Submit
  • I have checked for existing issues and pull requests related to my suggestion.
  • I have posted on the Nextcloud Community Help Forum if my suggestion is a troubleshooting scenario or I'm unsure about the solution.
Type of Suggestion

Suggesting an improvement

Relevant Documentation Links

https://docs.nextcloud.com/server/stable/admin_manual/configuration_user/user_auth_ldap_cleanup.html

Summary

I would like clarification on what it means when a user is marked as deleted

Details

After reading the documentation of the LDAP user cleanup, I'm unsure what exactly the LDAP cleanup is doing when it detects that a user no longer exists in the LDAP. I'll try to give my understanding of the process

  1. A user is found to be unavailable on LDAP
  2. The user is marked as deleted in the oc_preferences table. The user now shows up with occ ldap:show-remnants
  3. The cleanup deletes the items listed on the documentation page (group assignments, user preferences, home folder, oc_storages entry.

What remains of the user on the Nextcloud instance? The user account still exists and has to be manually deleted, but what other data of the user is still there while it is in its "marked deleted" state?

I think the page would benefit from a rewrite to clarifiy these things.

Additional Notes

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.