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

1.7K

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