Headnet

A web-ui for Headscale with a focus on easy ACL management thru 3D network visualization.

Developing

To circumvent CORS issues vite provides a dev proxy leading to your headscale instance. To enable this you have to define your headscale host as a environment variable.

# linux
export HEADSCALE_HOST="https://headscale.example.com"

# windows
$env:HEADSCALE_HOST="https://headscale.example.com"

Once you've installed dependencies with deno install, start a development server:

deno task dev

Building

To change the default base-url from /admin you have to set the environment variable BASE_PATH with your desired path before building the app.

deno task build

You can preview the production build with deno task preview.

Stack

Some of the major projects used:

• Deno 2
• Svelte 5
• Shadcn
• 3d-force-graph
• json-ast-comments
• openapi-typescript
• mock service worker

Note

Deno provides additional functionality such as automatic types for third party modules. NodeJS does not support this and will not work with this project during development / building.