Skip to content

docs(native-mode): document ./build.sh for the Headplane Agent binary#562

Closed
serge2day wants to merge 1 commit into
tale:mainfrom
serge2day:docs/native-mode-agent-build
Closed

docs(native-mode): document ./build.sh for the Headplane Agent binary#562
serge2day wants to merge 1 commit into
tale:mainfrom
serge2day:docs/native-mode-agent-build

Conversation

@serge2day
Copy link
Copy Markdown

Fixes #322.

The Native Mode install guide says to run pnpm install && pnpm build, but that doesn't build ./build/hp_agent. Anyone enabling integration.agent.enabled on a bare-metal install then hits ENOENT /usr/libexec/headplane/agent.

Switched the documented build command to ./build.sh (which builds the app, WASM, healthcheck, and the agent) and added a tip explaining why the old pnpm-only recipe doesn't produce hp_agent.

The Building Headplane step said to run pnpm install && pnpm build, but that
only builds the React Router app — it does not produce ./build/hp_agent.
Anyone enabling integration.agent.enabled on a bare-metal install then hits
the ENOENT for /usr/libexec/headplane/agent referenced in #322.

Switch the documented build command to ./build.sh (which builds the agent
along with the app, WASM, and healthcheck) and add a tip clarifying why the
old pnpm-only recipe doesn't yield hp_agent.
@serge2day serge2day requested a review from tale as a code owner May 26, 2026 22:59
@github-actions github-actions Bot added the Docs Improvements or additions to documentation label May 26, 2026
@serge2day serge2day closed this by deleting the head repository May 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bare metal integration agent

1 participant