Files
coolify-docs/content/docs/knowledge-base/delete-user.mdx
T
Andras Bacsai a64450ae9d feat(platform): migrate docs from VitePress to Fumadocs + TanStack Start
Replace VitePress/Vue stack with Fumadocs MDX, TanStack Start, React 19,
and Vite. Migrate all documentation content to MDX under content/docs/.
Add full src/ app with React components, routing, search, and API page.

Remove Korrektly integration from CI/CD workflows, Dockerfile, and env
vars. Update build pipeline to output to .output/public instead of
docs/.vitepress/dist.
2026-05-06 12:08:05 +02:00

53 lines
1.6 KiB
Plaintext

---
title: Delete User
description: "Safely delete users from Coolify with automatic team ownership transfer, resource cleanup, and team member reassignment procedures."
---
# Delete User
This guide will show you how to delete a user from the self-hosted Coolify instance.
<Callout type="warn" title="Caution">
If you delete a user, and Coolify still has connection to the servers, it will
delete all the resources on the servers as well, not just from Coolify's
database.
</Callout>
Only users who are in the `root` team can delete users from the UI.
- Go to the `Team` page.
- Switch to `Admin View` tab.
Here you can see all the users registered in Coolify. Click on the `Delete` button next to the user you want to delete.
## Deletion process
<Callout type="info" title="Tip">
The root team or root user cannot be deleted.
</Callout>
Coolify iterate over all the teams of a user and decide of the followings:
### The user is alone in the team
The team and all resources from the server and from Coolify's database are deleted.
### The user is not alone in the team
1. The user is the owner/admin of the team and no other owners/admins found, but the team **has members**:
- The ownership is transferred to the first user in the team who is not the owner/admin.
- The user is removed from the team. No resources are deleted.
2. The user is the owner/admin of the team and no other owners/admins found, but the team has **no members**:
- The team and all resources from the server and from Coolify's database are deleted.
3. The user is not the owner/admin of the team:
- The user is removed from the team. No resources are deleted.