chore: update docs to reflect 0.5.1
This commit is contained in:
parent
a7e4f3e4d2
commit
5b716ab5ce
35
docs/Headplane-Agent.md
Normal file
35
docs/Headplane-Agent.md
Normal file
@ -0,0 +1,35 @@
|
|||||||
|
# Headplane Agent
|
||||||
|
|
||||||
|
The Headplane agent is a lightweight service that runs alongside the Headscale server.
|
||||||
|
It's used to interface with devices on your network locally, unlocking the following:
|
||||||
|
|
||||||
|
- **Node Information/Status**: View Tailscale versions, OS versions, and connection details.
|
||||||
|
- **SSH via Web (Soon)**: Connect to devices via SSH directly from the Headplane UI.
|
||||||
|
|
||||||
|
It's built on top of [tsnet](https://tailscale.com/kb/1244/tsnet), the official
|
||||||
|
set of libraries published by Tailscale for creating local services that can
|
||||||
|
join the tailnet.
|
||||||
|
While it isn't required to run the agent, it's highly recommended to get the
|
||||||
|
closest experience to the SaaS version of Tailscale. This is paired with the
|
||||||
|
integrations provided by Headplane to manage DNS and Headscale settings.
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
The agent can either be ran as a standalone binary or as a Docker container.
|
||||||
|
Agent binaries are available on the [releases](https://github.com/tale/headplane/releases) page.
|
||||||
|
The Docker image is available through the `ghcr.io/tale/headplane-agent` tag.
|
||||||
|
|
||||||
|
The agent requires the following environment variables to be set:
|
||||||
|
- **`HP_AGENT_HOSTNAME`**: A hostname you want to use for the agent.
|
||||||
|
- **`HP_AGENT_TS_SERVER`**: The URL to your Headscale instance.
|
||||||
|
- **`HP_AGENT_TS_AUTHKEY`**: An authorization key to authenticate with Headscale (see below).
|
||||||
|
- **`HP_AGENT_HP_SERVER`**: The URL to your Headplane instance.
|
||||||
|
- **`HP_AGENT_HP_AUTHKEY`**: The generated auth key to authenticate with Headplane.
|
||||||
|
|
||||||
|
If you already have Headplane setup, you can generate all of these values within
|
||||||
|
the Headplane UI. Navigate to the `Settings` page and click `Agent` to get started.
|
||||||
|
|
||||||
|
HP_AGENT_HOSTNAME=headplane-agent
|
||||||
|
HP_AGENT_TS_SERVER=http://localhost:8080
|
||||||
|
#HP_AGENT_AUTH_KEY=3e0cd749021e5984267cde4b0a5a2ac32c1859e56f7911aa
|
||||||
|
HP_AGENT_TS_AUTHKEY=a4dab065c735cb4eae4f12804cf7e111206f9c7c9247c629
|
||||||
|
HP_AGENT_HP_SERVER=http://localhost:3000/admin
|
||||||
@ -34,7 +34,7 @@ Here is what a sample Docker Compose deployment would look like:
|
|||||||
services:
|
services:
|
||||||
headplane:
|
headplane:
|
||||||
# I recommend you pin the version to a specific release
|
# I recommend you pin the version to a specific release
|
||||||
image: ghcr.io/tale/headplane:0.5.0
|
image: ghcr.io/tale/headplane:0.5.1
|
||||||
container_name: headplane
|
container_name: headplane
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
ports:
|
ports:
|
||||||
@ -148,7 +148,7 @@ spec:
|
|||||||
serviceAccountName: default
|
serviceAccountName: default
|
||||||
containers:
|
containers:
|
||||||
- name: headplane
|
- name: headplane
|
||||||
image: ghcr.io/tale/headplane:0.5.0
|
image: ghcr.io/tale/headplane:0.5.1
|
||||||
env:
|
env:
|
||||||
# Set these if the pod name for Headscale is not static
|
# Set these if the pod name for Headscale is not static
|
||||||
# We will use the downward API to get the pod name instead
|
# We will use the downward API to get the pod name instead
|
||||||
|
|||||||
@ -19,7 +19,7 @@ Here is what a sample Docker Compose deployment would look like:
|
|||||||
services:
|
services:
|
||||||
headplane:
|
headplane:
|
||||||
# I recommend you pin the version to a specific release
|
# I recommend you pin the version to a specific release
|
||||||
image: ghcr.io/tale/headplane:0.5.0
|
image: ghcr.io/tale/headplane:0.5.1
|
||||||
container_name: headplane
|
container_name: headplane
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
ports:
|
ports:
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user