Skip to content

auberge headscale remove-user

Remove a Headscale user

Terminal window
auberge headscale remove-user [NAME] [OPTIONS]

auberge hs ru

Removes a user from the target Headscale instance. All nodes belonging to the user are also removed from the tailnet. By default, prompts for confirmation before proceeding.

Option Description Default
[NAME] Username to remove Interactive prompt
--host HOST Target host running headscale Serving host, else prompt
-y, --yes Skip confirmation prompt false
Terminal window
# Remove a user (with confirmation prompt)
auberge headscale remove-user --host myserver default
# Remove without confirmation
auberge headscale remove-user --host myserver default --yes
Remove user 'default'? [y/N]: y
✓ User 'default' removed

User has nodes attached: All nodes belonging to the user are removed automatically. Verify with auberge headscale list-nodes beforehand if you want to review what will be removed.