Installing host agent fails with 404

[jmatraszek]

Describe the bug
I try to install host agent, but the installation fails when the script tries to download pulse-host-agent. See below for the logs

To Reproduce
Steps to reproduce the behavior:

1. Copy command to install host agent
2. Execute the command on the host
3. See error

Expected behavior
Host agent installation succeeds.

Environment:

• Pulse Version: 4.26.4
• Installation Type: Bare metal running on Raspberry Pi 4, arch: aarch64 (arm64)
• Host architecture: amd64
• Running behind Caddy reverse proxy, but this seems to not be related

Additional context

# curl -fsSL https://pulse.example.dev/install-host-agent.sh | bash -s -- --url https://pulse.example.dev --token xxx --interval 30s

═══════════════════════════════════════════════════════════
  Pulse Host Agent - Installation
═══════════════════════════════════════════════════════════

ℹ Configuration:
  Pulse URL: https://pulse.example.dev
  Token: ***b91a
  Interval: 30s
  Platform: linux/amd64

ℹ Installing Pulse host agent for linux/amd64...
ℹ Downloading agent binary from https://example.example.dev...
curl: (22) The requested URL returned error: 404

✗ Failed to download agent binary from https://pulse.example.dev/download/pulse-host-agent?platform=linux&arch=amd64

ℹ Troubleshooting steps:

1. Verify the Pulse server is running:
   curl https://pulse.example.dev/health

2. Check if the download endpoint is accessible:
   curl -I https://pulse.example.dev/download/pulse-host-agent?platform=linux&arch=amd64

3. Build from source as a fallback:
   git clone https://github.com/rcourtman/Pulse.git
   cd Pulse
   go build -o pulse-host-agent ./cmd/pulse-host-agent
   sudo mv pulse-host-agent /usr/local/bin/
   # Then run this script again with --url and --token

4. Check firewall/network settings blocking the connection

curl 'https://pulse.example.dev/download/pulse-host-agent?platform=linux&arch=amd64'
Host agent binary not found for linux/amd64

Troubleshooting:
1. If running in Docker: Rebuild the Docker image to include all platform binaries
2. If running bare metal: Run 'scripts/build-release.sh' to build all platform binaries
3. Build from source:
   GOOS=linux GOARCH=amd64 go build -o pulse-host-agent-linux-amd64 ./cmd/pulse-host-agent
   sudo mv pulse-host-agent-linux-amd64 /opt/pulse/bin/

Searched locations:
  - /opt/pulse/bin/pulse-host-agent-linux-amd64
  - /opt/pulse/pulse-host-agent-linux-amd64
  - /app/pulse-host-agent-linux-amd64
  - /opt/pulse/bin/pulse-host-agent-linux
  - /opt/pulse/pulse-host-agent-linux
  - /app/pulse-host-agent-linux
  - /opt/pulse/bin/pulse-host-agent
  - /opt/pulse/pulse-host-agent
  - /app/pulse-host-agent

Pulse host agent not present there:

# ls -la /opt/pulse/bin/
total 46020
drwxr-xr-x 2 pulse pulse     4096 Nov  7 11:34 .
drwxr-xr-x 4 pulse pulse     4096 Nov  7 08:51 ..
-rwxr-xr-x 1 pulse pulse 18415800 Nov  7 11:34 pulse
-rwxr-xr-x 1 pulse pulse  7012536 Nov  7 11:34 pulse-docker-agent
-rwxr-xr-x 1 pulse pulse  7446712 Nov  7 08:51 pulse-docker-agent-linux-amd64
-rwxr-xr-x 1 pulse pulse  7012536 Nov  7 08:51 pulse-docker-agent-linux-arm64
-rwxr-xr-x 1 pulse pulse  7209144 Nov  7 08:51 pulse-docker-agent-linux-armv7

On the same host I was able to properly install pulse-docker-agent previously and it works without any issues. Shouldn't the binaries for host agent be built by scripts/build-release.sh?

💡 Tip: If you're experiencing connection issues, API errors, or missing data, you can attach diagnostics from Settings → Diagnostics tab → Export for GitHub (sanitized version)

[rcourtman]

Good catch. install.sh in v4.26.4 never copied the host agent binaries from the release tarball into /opt/pulse/bin, so the download endpoint falls through even though the files exist upstream.

If you want to fix it now, run the commands below to copy the binaries manually. Otherwise the next release will pick them up automatically during installation.

VERSION=v4.26.4
TMPDIR=$(mktemp -d)
cd "$TMPDIR"

curl -LO "https://github.com/rcourtman/Pulse/releases/download/v${VERSION}/pulse-v${VERSION}.tar.gz"
tar -xzf "pulse-v${VERSION}.tar.gz"

sudo mkdir -p /opt/pulse/bin
sudo cp bin/pulse-host-agent-* /opt/pulse/bin/
sudo chmod 755 /opt/pulse/bin/pulse-host-agent-*
sudo chown pulse:pulse /opt/pulse/bin/pulse-host-agent-* 2>/dev/null || true

ls -1 /opt/pulse/bin/pulse-host-agent-*

After those files exist, rerun the host agent installer and it will download successfully. The committed installer fix means this manual step will not be needed once the next release ships.

[jmatraszek]

Thanks @rcourtman for the swift fix! I'll think I will just wait for the next release, as this is not crucial for me. Closing the issue then.