debian-mirror-gitlab/doc/user/profile/account/delete_account.md

88 lines
3.4 KiB
Markdown
Raw Normal View History

2019-10-12 21:52:04 +05:30
---
type: howto
2020-06-23 00:09:42 +05:30
stage: Manage
2022-04-04 11:22:00 +05:30
group: Authentication and Authorization
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2019-10-12 21:52:04 +05:30
---
2022-05-07 20:08:51 +05:30
# Deleting a user account **(FREE)**
2019-10-12 21:52:04 +05:30
Users can be deleted from a GitLab instance, either by:
- The user themselves.
- An administrator.
2017-08-17 22:00:37 +05:30
2021-02-22 17:27:13 +05:30
NOTE:
2021-09-04 01:27:46 +05:30
Deleting a user deletes all projects in that user namespace.
2018-12-05 23:21:45 +05:30
2022-05-07 20:08:51 +05:30
## Delete your own account
2019-10-12 21:52:04 +05:30
2021-03-11 19:13:27 +05:30
As a user, to delete your own account:
2019-10-12 21:52:04 +05:30
2021-11-18 22:05:49 +05:30
1. On the top bar, in the top right corner, select your avatar.
2021-03-11 19:13:27 +05:30
1. Select **Edit profile**.
2021-11-11 11:23:49 +05:30
1. On the left sidebar, select **Account**.
2021-03-11 19:13:27 +05:30
1. Select **Delete account**.
2019-10-12 21:52:04 +05:30
2022-05-07 20:08:51 +05:30
## Delete users and user contributions **(FREE SELF)**
2019-10-12 21:52:04 +05:30
2021-03-11 19:13:27 +05:30
As an administrator, to delete a user account:
2019-10-12 21:52:04 +05:30
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Admin**.
2021-09-04 01:27:46 +05:30
1. On the left sidebar, select **Overview > Users**.
2021-03-11 19:13:27 +05:30
1. Select a user.
1. Under the **Account** tab, select:
2022-05-07 20:08:51 +05:30
- **Delete user** to delete only the user but maintain their [associated records](#associated-records). You can't use this option if
the selected user is the sole owner of any groups.
- **Delete user and contributions** to delete the user and their associated records. This option also removes all groups (and
projects within these groups) where the user is the sole direct Owner of a group. Inherited ownership doesn't apply.
2019-10-12 21:52:04 +05:30
2021-02-22 17:27:13 +05:30
WARNING:
2022-05-07 20:08:51 +05:30
Using the **Delete user and contributions** option may result in removing more data than intended. See
[associated records](#associated-records) for additional details.
2020-04-22 19:07:51 +05:30
2022-01-26 12:08:38 +05:30
### Associated records
2017-08-17 22:00:37 +05:30
2022-05-07 20:08:51 +05:30
When deleting users, you can either:
- Delete just the user. Not all associated records are deleted with the user. Instead of being deleted, these records
are moved to a system-wide user with the username Ghost User. The Ghost User's purpose is to act as a container for
such records. Any commits made by a deleted user still display the username of the original user.
- Delete the user and their contributions, including:
- Abuse reports.
- Award emojis.
- Epics.
- Groups of which the user is the only user with the Owner role.
- Issues.
- Merge requests.
- Notes and comments.
- Personal access tokens.
- Snippets.
An alternative to deleting is [blocking a user](../../admin_area/moderate_users.md#block-a-user).
When a user is deleted from an [abuse report](../../admin_area/review_abuse_reports.md) or spam log, these associated
records are always removed.
The deleting associated records option can be requested in the [API](../../../api/users.md#user-deletion) as well as
the Admin Area.
2019-10-12 21:52:04 +05:30
2022-04-04 11:22:00 +05:30
## Troubleshooting
2019-10-12 21:52:04 +05:30
2022-04-04 11:22:00 +05:30
### Deleting a user results in a PostgreSQL null value error
2017-08-17 22:00:37 +05:30
2022-04-04 11:22:00 +05:30
There is [a known issue](https://gitlab.com/gitlab-org/gitlab/-/issues/349411) that results
in users not being deleted, and the following error generated:
```plaintext
ERROR: null value in column "user_id" violates not-null constraint
```
2022-08-27 11:52:29 +05:30
The error can be found in the [PostgreSQL log](../../../administration/logs/index.md#postgresql-logs) and
2022-04-04 11:22:00 +05:30
in the **Retries** section of the [background jobs view](../../admin_area/index.md#background-jobs) in the Admin Area.
If the user being deleted used the [iterations](../../group/iterations/index.md) feature, such
as adding an issue to an iteration, you must use
[the workaround documented in the issue](https://gitlab.com/gitlab-org/gitlab/-/issues/349411#workaround)
to delete the user.