Sign inSign up

djh00t/headscale-cli

By djh00t

•Updated over 3 years ago

CLI tools image used to remotely manage Headscale servers. https://github.com/juanfont/headscale

Image
1

2.0K

djh00t/headscale-cli repository overview

⁠Headscale CLI & Tools Container

This container contains the CLI tools⁠ for Headscale⁠ and some additional scripts I have found useful while managing Headscale servers.

More information on using Headscale CLI Tools⁠ can be found here⁠.

⁠Generate API Keys

In order to remotely manage Headscale you need to run the following commands on the Headscale instance you wish to manage:

  1. Create an API key headscale apikeys create --expiration 90d Copy the output of the command and save it for later. Please note that you can not retrieve a key again, if the key is lost, expire the old one, and create a new key.
  2. To view issued keys headscale apikeys list
  3. To expire a key headscale apikeys expire --prefix "<PREFIX>"
⁠Container Variables

The following variables exist for the Headscale CLI Tools.

VariableExampleDescription
HEADSCALE_CLI_ADDRESS"headscale.example.com:50443"Hostname and Port of Headscale instance you wish to manage.
HEADSCALE_CLI_API_KEY"abcde12345"API Key for Headscale instance you wish to manage.
HEADSCALE_CLI_INSECURE"0"Boolean value telling Headscale CLI Tools if it should use TLS or not.

Tag summary

Content type

Image

Digest

sha256:8a86fdadd…

Size

31 MB

Last updated

over 3 years ago

docker pull djh00t/headscale-cli