chore: prepare v4.22.0-rc.1

Author: rcourtman

Dockerfile

@@ -35,11 +35,15 @@ COPY VERSION ./
 # Must be at internal/api/frontend-modern for Go embed
 COPY --from=frontend-builder /app/frontend-modern/dist ./internal/api/frontend-modern/dist
 
-# Build the binary with embedded frontend
+# Build the binaries with embedded frontend
 RUN CGO_ENABLED=0 GOOS=linux go build \
  -ldflags="-s -w" \
  -trimpath \
- -o pulse ./cmd/pulse
+ -o pulse ./cmd/pulse && \
+ CGO_ENABLED=0 GOOS=linux go build \
+ -ldflags="-s -w" \
+ -trimpath \
+ -o pulse-docker-agent ./cmd/pulse-docker-agent
 
 # Final stage
 FROM alpine:latest
@@ -48,8 +52,9 @@ RUN apk --no-cache add ca-certificates tzdata su-exec
 
 WORKDIR /app
 
-# Copy binary from builder (frontend is embedded)
+# Copy binaries from builder (frontend is embedded)
 COPY --from=backend-builder /app/pulse .
+COPY --from=backend-builder /app/pulse-docker-agent .
 
 # Copy VERSION file
 COPY --from=backend-builder /app/VERSION .
@@ -83,4 +88,4 @@ HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
 ENTRYPOINT ["/docker-entrypoint.sh"]
 
 # Run the binary
-CMD ["./pulse"]
+CMD ["./pulse"]

VERSION

@@ -1 +1 @@
-4.21.0
+4.22.0-rc.1

docs/DOCKER_MONITORING.md

@@ -16,7 +16,7 @@ Data is pushed to Pulse over HTTPS using your existing API token – no inbound
 
 ## Prerequisites
 
-- Pulse vX.Y.Z or newer with an API token enabled (`Settings → Security`)
+- Pulse v4.22.0 or newer with an API token enabled (`Settings → Security`)
 - Docker 20.10+ on Linux (the agent uses the Docker Engine API via the local socket)
 - Access to the Docker socket (`/var/run/docker.sock`) or a configured `DOCKER_HOST`
 - Go 1.24+ if you plan to build the binary from source
@@ -33,6 +33,15 @@ GOOS=linux GOARCH=amd64 go build -o pulse-docker-agent ./cmd/pulse-docker-agent
 
 Copy the binary to your Docker host (e.g. `/usr/local/bin/pulse-docker-agent`) and make it executable.
 
+### Quick install from your Pulse server
+
+Use the bundled installation script (ships with Pulse v4.22.0+) to deploy and manage the agent. Replace the token placeholder with an API token generated in **Settings → Security**.
+
+```bash
+curl -fsSL http://pulse.example.com/install-docker-agent.sh \
+ | sudo bash -s -- --url http://pulse.example.com --token <api-token>
+```
+
 ## Running the agent
 
 The agent needs to know where Pulse lives and which API token to use. You can supply these via flags or environment variables:
@@ -80,7 +89,7 @@ docker run -d \
  ghcr.io/rcourtman/pulse-docker-agent:latest
 ```
 
-> **Note**: The container image will be published starting with the first release that ships this agent. Build locally if you are testing main.
+> **Note**: The container image is published with the first release that includes the agent. Build locally if you are testing nightly builds.
 
 ## Configuration reference
 

docs/development/MOCK_MODE.md

@@ -34,6 +34,8 @@ PULSE_MOCK_MODE=false # Disabled by default
 PULSE_MOCK_NODES=7
 PULSE_MOCK_VMS_PER_NODE=5
 PULSE_MOCK_LXCS_PER_NODE=8
+PULSE_MOCK_DOCKER_HOSTS=3
+PULSE_MOCK_DOCKER_CONTAINERS=12
 PULSE_MOCK_RANDOM_METRICS=true
 PULSE_MOCK_STOPPED_PERCENT=20
 ```
@@ -54,6 +56,8 @@ The `.local` file overrides values from `mock.env`, and is gitignored to keep yo
 - `PULSE_MOCK_NODES`: Number of nodes to generate (default: 7)
 - `PULSE_MOCK_VMS_PER_NODE`: Average VMs per node (default: 5)
 - `PULSE_MOCK_LXCS_PER_NODE`: Average containers per node (default: 8)
+- `PULSE_MOCK_DOCKER_HOSTS`: Number of Docker hosts to generate (default: 3)
+- `PULSE_MOCK_DOCKER_CONTAINERS`: Average containers per Docker host (default: 12)
 - `PULSE_MOCK_RANDOM_METRICS`: Enable metric fluctuations (`true`/`false`)
 - `PULSE_MOCK_STOPPED_PERCENT`: Percentage of guests in stopped state (default: 20)
 

docs/development/mock.env.local.example

@@ -16,6 +16,10 @@ PULSE_MOCK_NODES=3
 # Example: More VMs for testing high-density scenarios
 # PULSE_MOCK_VMS_PER_NODE=10
 
+# Example: Adjust Docker coverage
+# PULSE_MOCK_DOCKER_HOSTS=2
+# PULSE_MOCK_DOCKER_CONTAINERS=6
+
 # Example: Disable metric fluctuations for consistent testing
 # PULSE_MOCK_RANDOM_METRICS=false
 

frontend-modern/src/components/Docker/DockerHosts.tsx

@@ -280,10 +280,10 @@ const DockerContainerRow: Component<{
  }`}
  >
  <td class="px-4 py-2" colSpan={5}>
- <div class="flex flex-wrap gap-3 justify-start">
+ <div class="grid w-full gap-3 sm:grid-cols-2 lg:grid-cols-3">
  {/* Network & IPs */}
  <Show when={container.networks && container.networks.length > 0}>
- <div class="min-w-[220px] rounded border border-gray-200 bg-white/70 p-2 shadow-sm dark:border-gray-600/70 dark:bg-gray-900/30">
+ <div class="rounded border border-gray-200 bg-white/70 p-2 shadow-sm dark:border-gray-600/70 dark:bg-gray-900/30">
  <div class="text-[11px] font-medium text-gray-700 dark:text-gray-200">Network</div>
  <div class="mt-1 space-y-1">
  <For each={container.networks}>
@@ -312,7 +312,7 @@ const DockerContainerRow: Component<{
 
  {/* Ports */}
  <Show when={container.ports && container.ports.length > 0}>
- <div class="min-w-[220px] rounded border border-gray-200 bg-white/70 p-2 shadow-sm dark:border-gray-600/70 dark:bg-gray-900/30">
+ <div class="rounded border border-gray-200 bg-white/70 p-2 shadow-sm dark:border-gray-600/70 dark:bg-gray-900/30">
  <div class="text-[11px] font-medium text-gray-700 dark:text-gray-200">Ports</div>
  <div class="mt-1 flex flex-wrap gap-1">
  <For each={container.ports}>
@@ -331,7 +331,7 @@ const DockerContainerRow: Component<{
  </Show>
 
  {/* Container Info */}
- <div class="min-w-[220px] rounded border border-gray-200 bg-white/70 p-2 shadow-sm dark:border-gray-600/70 dark:bg-gray-900/30">
+ <div class="rounded border border-gray-200 bg-white/70 p-2 shadow-sm dark:border-gray-600/70 dark:bg-gray-900/30">
  <div class="text-[11px] font-medium text-gray-700 dark:text-gray-200">Info</div>
  <div class="mt-1 space-y-1 text-gray-600 dark:text-gray-300">
  <Show when={container.image}>

frontend-modern/src/components/Settings/DockerAgents.tsx

@@ -24,9 +24,11 @@ export const DockerAgents: Component = () => {
  return 'http://localhost:7655';
  };
 
+ const TOKEN_PLACEHOLDER = '<api-token>';
+
  const getInstallCommand = () => {
  const url = pulseUrl();
- return `curl -fsSL ${url}/install-docker-agent.sh | bash -s -- --url ${url}`;
+ return `curl -fsSL ${url}/install-docker-agent.sh | bash -s -- --url ${url} --token ${TOKEN_PLACEHOLDER}`;
  };
 
  const getUninstallCommand = () => {
@@ -42,7 +44,8 @@ Wants=network-online.target
 
 [Service]
 Type=simple
-ExecStart=/usr/local/bin/pulse-docker-agent --url ${pulseUrl()} --token disabled --interval 30s
+Environment=PULSE_TOKEN=${TOKEN_PLACEHOLDER}
+ExecStart=/usr/local/bin/pulse-docker-agent --url ${pulseUrl()} --interval 30s
 Restart=always
 RestartSec=5s
 User=root
@@ -152,7 +155,8 @@ WantedBy=multi-user.target`;
  <code class="text-sm text-green-400 font-mono">{getInstallCommand()}</code>
  </div>
  <p class="text-xs text-gray-500 dark:text-gray-400">
- This will download the agent binary, create a systemd service, and start monitoring automatically.
+ Replace <code class="px-1 bg-gray-100 dark:bg-gray-800 rounded">{TOKEN_PLACEHOLDER}</code> with the API token from{' '}
+ <span class="font-medium">Settings → Security</span>. The script downloads the agent, creates a systemd service, and starts monitoring automatically.
  </p>
  </div>
 
@@ -232,7 +236,8 @@ WantedBy=multi-user.target`;
  </div>
  </div>
  <p class="text-xs text-gray-500 dark:text-gray-400 mt-2">
- Save to <code class="px-1 py-0.5 bg-gray-100 dark:bg-gray-800 rounded">/etc/systemd/system/pulse-docker-agent.service</code>
+ Save to <code class="px-1 py-0.5 bg-gray-100 dark:bg-gray-800 rounded">/etc/systemd/system/pulse-docker-agent.service</code> and replace{' '}
+ <code class="px-1 bg-gray-100 dark:bg-gray-800 rounded">{TOKEN_PLACEHOLDER}</code> with a valid API token.
  </p>
  </div>
 

install.sh

@@ -1291,7 +1291,7 @@ download_pulse() {
  fi
 
  # Check Go version and install newer version if needed
- GO_MIN_VERSION="1.21"
+ GO_MIN_VERSION="1.24"
  GO_INSTALLED=false
  if command -v go >/dev/null 2>&1; then
  GO_VERSION=$(go version | grep -oE '[0-9]+\.[0-9]+' | head -1)
@@ -1302,7 +1302,7 @@ download_pulse() {
  fi
 
  if [[ "$GO_INSTALLED" != "true" ]]; then
- print_info "Installing Go 1.23 (system Go is too old or missing)..."
+ print_info "Installing Go 1.24 (system Go is too old or missing)..."
  # Detect architecture for Go download
  ARCH=$(uname -m)
  case $ARCH in
@@ -1322,11 +1322,11 @@ download_pulse() {
  esac
 
  cd /tmp
- wget -q "https://go.dev/dl/go1.23.4.linux-${GO_ARCH}.tar.gz"
+ wget -q "https://go.dev/dl/go1.24.7.linux-${GO_ARCH}.tar.gz"
  rm -rf /usr/local/go
- tar -C /usr/local -xzf "go1.23.4.linux-${GO_ARCH}.tar.gz"
+ tar -C /usr/local -xzf "go1.24.7.linux-${GO_ARCH}.tar.gz"
  export PATH=/usr/local/go/bin:$PATH
- rm "go1.23.4.linux-${GO_ARCH}.tar.gz"
+ rm "go1.24.7.linux-${GO_ARCH}.tar.gz"
  fi
 
  # Create temp directory for build
@@ -1384,6 +1384,20 @@ download_pulse() {
  fi
 
  chmod +x "$INSTALL_DIR/bin/pulse"
+
+ print_info "Building Docker agent from source..."
+ if ! go build -o pulse-docker-agent ./cmd/pulse-docker-agent >/dev/null 2>&1; then
+ print_error "Failed to build Docker agent binary"
+ exit 1
+ fi
+
+ cp -f pulse-docker-agent "$INSTALL_DIR/pulse-docker-agent"
+ cp -f pulse-docker-agent "$INSTALL_DIR/bin/pulse-docker-agent"
+ chmod +x "$INSTALL_DIR/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ chown -R pulse:pulse "$INSTALL_DIR"
+ ln -sf "$INSTALL_DIR/bin/pulse-docker-agent" /usr/local/bin/pulse-docker-agent
+
+ rm -f pulse-docker-agent
 
  # Update VERSION file to show it's from source
  echo "$SOURCE_BRANCH-$(git rev-parse --short HEAD)" > "$INSTALL_DIR/VERSION"
@@ -1492,6 +1506,18 @@ download_pulse() {
  fi
  exit 1
  fi
+
+ # Install Docker agent binary for distribution
+ if [[ -f "$TEMP_EXTRACT/bin/pulse-docker-agent" ]]; then
+ cp -f "$TEMP_EXTRACT/bin/pulse-docker-agent" "$INSTALL_DIR/pulse-docker-agent"
+ cp -f "$TEMP_EXTRACT/bin/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ chmod +x "$INSTALL_DIR/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ chown pulse:pulse "$INSTALL_DIR/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ ln -sf "$INSTALL_DIR/bin/pulse-docker-agent" /usr/local/bin/pulse-docker-agent
+ print_success "Docker agent binary installed"
+ else
+ print_warn "Docker agent binary not found in archive; skipping installation"
+ fi
 
  chmod +x "$INSTALL_DIR/bin/pulse"
  chown -R pulse:pulse "$INSTALL_DIR"
@@ -1529,6 +1555,13 @@ download_pulse() {
  elif [[ -f "$TEMP_EXTRACT2/pulse" ]]; then
  cp -f "$TEMP_EXTRACT2/pulse" "$INSTALL_DIR/bin/pulse"
  fi
+
+ if [[ -f "$TEMP_EXTRACT2/bin/pulse-docker-agent" ]]; then
+ cp -f "$TEMP_EXTRACT2/bin/pulse-docker-agent" "$INSTALL_DIR/pulse-docker-agent"
+ cp -f "$TEMP_EXTRACT2/bin/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ chmod +x "$INSTALL_DIR/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ ln -sf "$INSTALL_DIR/bin/pulse-docker-agent" /usr/local/bin/pulse-docker-agent
+ fi
 
  chmod +x "$INSTALL_DIR/bin/pulse"
  chown -R pulse:pulse "$INSTALL_DIR"
@@ -1889,11 +1922,11 @@ main() {
  # Check for Go installation
  GO_INSTALLED=false
  if ! command -v go &> /dev/null; then
- print_info "Go is not installed. Installing Go 1.23..."
+ print_info "Go is not installed. Installing Go 1.24..."
  else
  GO_VERSION=$(go version | grep -oP 'go\K[0-9]+\.[0-9]+')
- if awk "BEGIN {exit !($GO_VERSION < 1.23)}"; then
- print_info "Go version $GO_VERSION is too old. Installing Go 1.23..."
+ if awk "BEGIN {exit !($GO_VERSION < 1.24)}"; then
+ print_info "Go version $GO_VERSION is too old. Installing Go 1.24..."
  else
  print_info "Go version $GO_VERSION is installed"
  GO_INSTALLED=true
@@ -1911,7 +1944,7 @@ main() {
  GO_ARCH="arm64"
  ;;
  armv7l)
- GO_ARCH="armv7"
+ GO_ARCH="armv6l"
  ;;
  *)
  print_error "Unsupported architecture: $ARCH"
@@ -1920,11 +1953,11 @@ main() {
  esac
 
  cd /tmp
- wget -q "https://go.dev/dl/go1.23.4.linux-${GO_ARCH}.tar.gz"
+ wget -q "https://go.dev/dl/go1.24.7.linux-${GO_ARCH}.tar.gz"
  rm -rf /usr/local/go
- tar -C /usr/local -xzf "go1.23.4.linux-${GO_ARCH}.tar.gz"
+ tar -C /usr/local -xzf "go1.24.7.linux-${GO_ARCH}.tar.gz"
  export PATH=/usr/local/go/bin:$PATH
- rm "go1.23.4.linux-${GO_ARCH}.tar.gz"
+ rm "go1.24.7.linux-${GO_ARCH}.tar.gz"
  fi
 
  # Clone and build
@@ -1978,8 +2011,21 @@ main() {
  cp pulse "$INSTALL_DIR/bin/pulse"
  chmod +x "$INSTALL_DIR/bin/pulse"
  chown pulse:pulse "$INSTALL_DIR/bin/pulse"
- 
- # Create symlink for backward compatibility
+
+ print_info "Building Docker agent from source..."
+ if ! go build -o pulse-docker-agent ./cmd/pulse-docker-agent >/dev/null 2>&1; then
+ print_error "Failed to build Docker agent binary"
+ cd /
+ rm -rf "$TEMP_BUILD_DIR"
+ exit 1
+ fi
+
+ cp -f pulse-docker-agent "$INSTALL_DIR/pulse-docker-agent"
+ cp -f pulse-docker-agent "$INSTALL_DIR/bin/pulse-docker-agent"
+ chmod +x "$INSTALL_DIR/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ chown pulse:pulse "$INSTALL_DIR/pulse-docker-agent" "$INSTALL_DIR/bin/pulse-docker-agent"
+ ln -sf "$INSTALL_DIR/bin/pulse-docker-agent" /usr/local/bin/pulse-docker-agent
+ rm -f pulse-docker-agent
  ln -sf "$INSTALL_DIR/bin/pulse" /usr/local/bin/pulse
 
  # Setup update command and service