headscalez: a library for an embedded Headscale server

[DecDuck]

As part of our development of the P2P functionality for Drop, we've released a library called headscalez. It's built to download, set-up, configure, and run an embedded Headscale instance, and provide a Typescript interface to interact with it. Currently, it only supports Linux, but both amd64 & arm64.

It's core functionality is available through startHeadscale(_opts), which returns an instance of HeadscaleService. You can call .close() directly on this to shut down the server, or pass it to the constructor of HeadscaleControlService.

HeadscaleControlService.client is a gRPC object, and has Typescript-equivalent functions for all functionality of Headscale.

You can check out the package here: https://www.npmjs.com/package/@drop-oss/headscalez

Or the GitHub project here: https://github.com/Drop-OSS/headscalez