Error: unknown command "headscale" for "headscale" Running headscale in a container #664

Closed
opened 2025-12-29 02:21:46 +01:00 by adam · 5 comments
Owner

Originally created by @mockte on GitHub (Mar 12, 2024).

Originally assigned to: @ohdearaugustin on GitHub.

URL: https://github.com/juanfont/headscale/blob/v0.23.0-alpha5/docs/running-headscale-container.md

when I start docker container, get error:

[root@LESSZHDEVPR01 headscale]# docker logs headscale
Error: unknown command "headscale" for "headscale"
Run 'headscale --help' for usage.
unknown command "headscale" for "headscale"

how can I fixed it?

Originally created by @mockte on GitHub (Mar 12, 2024). Originally assigned to: @ohdearaugustin on GitHub. URL: https://github.com/juanfont/headscale/blob/v0.23.0-alpha5/docs/running-headscale-container.md when I start docker container, get error: [root@LESSZHDEVPR01 headscale]# docker logs headscale Error: unknown command "headscale" for "headscale" Run 'headscale --help' for usage. unknown command "headscale" for "headscale" how can I fixed it?
adam added the enhancementstale labels 2025-12-29 02:21:46 +01:00
adam closed this issue 2025-12-29 02:21:46 +01:00
Author
Owner

@winterheart commented on GitHub (Mar 12, 2024):

Hello.

0.23.0-alpha5 changes way to run headscale in container (https://github.com/juanfont/headscale/releases/tag/v0.23.0-alpha5). You need to change headscale serve to serve on launch command. I.e.:

docker run \
  --name headscale \
  --detach \
  --volume $(pwd)/config:/etc/headscale/ \
  --publish 127.0.0.1:8080:8080 \
  --publish 127.0.0.1:9090:9090 \
  headscale/headscale: 0.23.0-alpha5 \
  serve
@winterheart commented on GitHub (Mar 12, 2024): Hello. 0.23.0-alpha5 changes way to run headscale in container (https://github.com/juanfont/headscale/releases/tag/v0.23.0-alpha5). You need to change `headscale serve` to `serve` on launch command. I.e.: ``` docker run \ --name headscale \ --detach \ --volume $(pwd)/config:/etc/headscale/ \ --publish 127.0.0.1:8080:8080 \ --publish 127.0.0.1:9090:9090 \ headscale/headscale: 0.23.0-alpha5 \ serve ```
Author
Owner

@ohdearaugustin commented on GitHub (Mar 14, 2024):

The documentation is currently still for the stable version 0.22.3. You can just run the stable version or join the discord to discuss with people to run the newer alpha version.

Some new documentation should be available in the future.

@ohdearaugustin commented on GitHub (Mar 14, 2024): The documentation is currently still for the stable version 0.22.3. You can just run the stable version or join the discord to discuss with people to run the newer alpha version. Some new documentation should be available in the future.
Author
Owner

@kradalby commented on GitHub (May 27, 2024):

I've assigned @ohdearaugustin , hope you can help us update the docs when 0.23.0 is about to be released

@kradalby commented on GitHub (May 27, 2024): I've assigned @ohdearaugustin , hope you can help us update the docs when 0.23.0 is about to be released
Author
Owner

@github-actions[bot] commented on GitHub (Aug 26, 2024):

This issue is stale because it has been open for 90 days with no activity.

@github-actions[bot] commented on GitHub (Aug 26, 2024): This issue is stale because it has been open for 90 days with no activity.
Author
Owner

@github-actions[bot] commented on GitHub (Sep 2, 2024):

This issue was closed because it has been inactive for 14 days since being marked as stale.

@github-actions[bot] commented on GitHub (Sep 2, 2024): This issue was closed because it has been inactive for 14 days since being marked as stale.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/headscale#664