starred/headscale
1
0
Fork 0
mirror of https://github.com/juanfont/headscale.git synced 2026-01-12 04:10:32 +01:00
Code Issues 98 Packages Projects Releases 10 Wiki Activity

[Bug] Container doesn't begin serving, instead shows help and exits. #1131

New Issue
Closed
opened 2025-12-29 02:28:28 +01:00 by adam · 1 comment
adam commented 2025-12-29 02:28:28 +01:00
Owner
Copy Link

Originally created by @bill88t on GitHub (Oct 30, 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

Starting docker.io/headscale/headscale:latest results in:

[bill88t@prion | /docker]> docker run -it --rm docker.io/headscale/headscale:latest

headscale is an open source implementation of the Tailscale control server

https://github.com/juanfont/headscale

Usage:
  headscale [command]

Available Commands:
  apikeys     Handle the Api keys in Headscale
  completion  Generate the autocompletion script for the specified shell
  configtest  Test the configuration.
  debug       debug and testing commands
  generate    Generate commands
  health      Check the health of the Headscale server
  help        Help about any command
  mockoidc    Runs a mock OIDC server for testing
  nodes       Manage the nodes of Headscale
  policy      Manage the Headscale ACL Policy
  preauthkeys Handle the preauthkeys in Headscale
  serve       Launches the headscale server
  users       Manage the users of Headscale
  version     Print the version.

Flags:
  -c, --config string   config file (default is /etc/headscale/config.yaml)
      --force           Disable prompts and forces the execution
  -h, --help            help for headscale
  -o, --output string   Output format. Empty for human-readable, 'json', 'json-line' or 'yaml'

Use "headscale [command] --help" for more information about a command.

Expected Behavior

It should begin serving instead of showing help?

Steps To Reproduce

docker run -it --rm docker.io/headscale/headscale:latest

Environment

- OS: BredOS Linux ARM64 (Arch based)
- Headscale version: Docker Latest
- Tailscale version: N/A

Runtime environment

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

Debug information

N/A

Originally created by @bill88t on GitHub (Oct 30, 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 Starting `docker.io/headscale/headscale:latest` results in: ``` [bill88t@prion | /docker]> docker run -it --rm docker.io/headscale/headscale:latest headscale is an open source implementation of the Tailscale control server https://github.com/juanfont/headscale Usage: headscale [command] Available Commands: apikeys Handle the Api keys in Headscale completion Generate the autocompletion script for the specified shell configtest Test the configuration. debug debug and testing commands generate Generate commands health Check the health of the Headscale server help Help about any command mockoidc Runs a mock OIDC server for testing nodes Manage the nodes of Headscale policy Manage the Headscale ACL Policy preauthkeys Handle the preauthkeys in Headscale serve Launches the headscale server users Manage the users of Headscale version Print the version. Flags: -c, --config string config file (default is /etc/headscale/config.yaml) --force Disable prompts and forces the execution -h, --help help for headscale -o, --output string Output format. Empty for human-readable, 'json', 'json-line' or 'yaml' Use "headscale [command] --help" for more information about a command. ``` ### Expected Behavior It should begin serving instead of showing help? ### Steps To Reproduce `docker run -it --rm docker.io/headscale/headscale:latest` ### Environment ```markdown - OS: BredOS Linux ARM64 (Arch based) - Headscale version: Docker Latest - Tailscale version: N/A ``` ### Runtime environment - [x] Headscale is behind a (reverse) proxy - [x] Headscale runs in a container ### Debug information N/A
adam added the bug label 2025-12-29 02:28:28 +01:00
adam closed this issue 2025-12-29 02:28:28 +01:00
adam commented 2025-12-29 02:28:28 +01:00
Author
Owner
Copy Link

@kradalby commented on GitHub (Oct 30, 2025):

No, you need to pass it serve if you want to serve, it can also be used as the CLI.

@kradalby commented on GitHub (Oct 30, 2025): No, you need to pass it `serve` if you want to serve, it can also be used as the CLI.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
CLI
DERP
DNS
Nix
OIDC
SSH
bug
database
documentation
duplicate
enhancement
faq
good first issue
grants
help wanted
might-come
needs design doc
needs investigation
no-stale-bot
out of scope
performance
policy 📝
pull-request
Mirrored from GitHub Pull Request
 question
regression
routes
stale
tags
tailscale-feature-gap
well described ❤️
wontfix
No Label bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/headscale#1131
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?