DocsInstallCLI ReferenceCommunityGitHub ↗
installcurl -fsSL https://raw.githubusercontent.com/tuzlu07x/foreman-agent/main/install.sh | bash
Get started

Install Foreman.

Pick your OS, copy one line, run it. Node 20+ is handled for you. Nothing phones home.

One line. Detects your shell, installs Node 20 via nvm if missing, then Foreman.

$ curl -fsSL https://raw.githubusercontent.com/tuzlu07x/foreman-agent/main/install.sh | bash

Install script options

Optional environment variables — most people never touch these.

FOREMAN_VERSION=0.1.0Pin the install to a specific release.
FOREMAN_INSTALL_PREFIXUse a custom global npm prefix.
FOREMAN_SKIP_NVM=1Refuse the nvm bootstrap; use your own Node.

Removes the global package. Your config & audit log in ~/.foreman/ are left untouched.

$ curl -fsSL .../install.sh | bash -s -- --uninstall

Verify the install

$ foreman --version
foreman/0.1.0 node-v20.11.0
$ foreman doctor   # diagnose Node, paths, db, FTS5, policy, agents…
✓ node 20.11.0   ✓ ~/.foreman writable   ✓ sqlite + FTS5
✓ policy.yaml ok   ✓ ed25519 identity   ✓ 0 agents registered
Seeing all ✓ in the output? You're ready. Head to the Quick Start.
NextQuick Start Initialize, launch the gateway, and wire your first agent in about five minutes.