[Bug] "Getting started" doc suggests one tailnet per user #902

Closed
opened 2025-12-29 02:25:36 +01:00 by adam · 0 comments
Owner

Originally created by @samuelallan72 on GitHub (Jan 9, 2025).

Is this a support request?

  • This is not a support request

Is there an existing issue for this?

  • I have searched the existing issues

Current Behavior

On https://headscale.net/stable/usage/getting-started/ , under "Manage users", there is this sentence:

In headscale, a node (also known as machine or device) is always assigned to a specific user, a tailnet.

This wording suggests that a user is equivalent to a tailnet; ie. one tailnet per user. This however, is not correct for headscale.

Expected Behavior

The wording should be clear that a headscale server provides a single global tailnet, and all users are in the same tailnet.

It would also be nice to be clearer about what the concept of a user is, in the context of headscale - this has confused me a bit.

Steps To Reproduce

.

Environment

.

Runtime environment

  • Headscale is behind a (reverse) proxy
  • Headscale runs in a container

Anything else?

No response

Originally created by @samuelallan72 on GitHub (Jan 9, 2025). ### Is this a support request? - [X] This is not a support request ### Is there an existing issue for this? - [X] I have searched the existing issues ### Current Behavior On https://headscale.net/stable/usage/getting-started/ , under "Manage users", there is this sentence: > In headscale, a node (also known as machine or device) is always assigned to a specific user, a tailnet. This wording suggests that a user is equivalent to a tailnet; ie. one tailnet per user. This however, is not correct for headscale. ### Expected Behavior The wording should be clear that a headscale server provides a single global tailnet, and all users are in the same tailnet. It would also be nice to be clearer about what the concept of a user is, in the context of headscale - this has confused me a bit. ### Steps To Reproduce . ### Environment ```markdown . ``` ### Runtime environment - [ ] Headscale is behind a (reverse) proxy - [ ] Headscale runs in a container ### Anything else? _No response_
adam added the bugdocumentation labels 2025-12-29 02:25:36 +01:00
adam closed this issue 2025-12-29 02:25:36 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/headscale#902