Changelog
All notable changes to hostcd are documented here. This project uses date-based
vMAJOR.MINOR.PATCH tags; security releases are called out explicitly.
[0.3.21] — 2026-11-16
A security release. The fixes from the 2026-11 security review that had landed on
main are now shipped; no new resource kinds or features.
Security
- The standalone
hostcdserver authenticates/status,/metricsand/sync. When a sync token is configured these endpoints are no longer open; without one the server binds loopback-only by default and logs a warning if it is placed on a non-loopback address unauthenticated. (#236) - Server-side request forgery via Team webhooks is blocked at dial time. Webhook delivery now refuses loopback, link-local, the cloud metadata address (169.254.169.254) and multicast targets — covering redirects and DNS rebinding — while ordinary private ranges stay allowed for on-prem endpoints. The server also gained idle and header-size limits. (#234)
golang.org/x/netupgraded to 0.62.0 to pick up the fix for CVE-2026-78661. (#229)
Changed
- Internal hardening, no behaviour change. golangci-lint (with gosec) now runs
in CI and
make lint; a scheduled gitleaks / trivy / govulncheck scan runs every two days and on each release tag; the port-forward proxy moved off the deprecatedDirectorAPI; and the largest server files were split for maintainability. (#219, #221, #223, #225, #227, #231, #232)
[0.3.20] — 2026-11-12
A small maintenance release: the fixes accumulated since v0.3.19, no new resource kinds or features.
Added
- "Check for updates" button in Settings → Software updates. It forces a fresh check against the release channel and shows "You're up to date" when there is nothing new, or offers the update (one-click when the server has the updater configured) — so an operator no longer has to wait out the background poll or rely on the passive banner.
Fixed
- Settings were stale right after a form login.
/api/settingsis now refetched immediately after login (as it already was on a page reload), so the license card, the nav update banner and the installed-version row render correctly instead of appearing empty until the next reload.
Changed
- Honest status on read-only instances. A read-only server (the public demo)
no longer advertises Team-trial write permissions it cannot exercise: the
UI/API entitlement view reports the write-capable permissions as unavailable and
flags
readOnly, while enforcement is unchanged (read-only is already enforced at the HTTP layer). The Recovery "Backup & restore" card labels the UI export/import as config export/import and points atreliability/pilot-restore-drill.shfor the actual data-dir disaster-recovery rehearsal. - The release publishes the site hands-free. The docs-sync PR to the public
hostcd-distsite now auto-merges once its consistency check passes, instead of waiting for a manual merge every release.
Reliability
- Real-data restore drill for the live pilot (
reliability/pilot-restore-drill.shPILOT-RESTORE-REPORT.md): a non-destructive drill that backs up the live data dir, restores it onto a throwaway instance, confirms the real applications and hosts recover and the sealed secrets decrypt, and checks that a mismatchedbootstrap.keyfails closed — the disaster-recovery evidence on real state, not just the synthetic CI drill.
[0.3.19] — 2026-11-11
Added
nvidia_gpuresource kind — converge a GPU bare-metal host to the full NVIDIA monitoring stack from Git in one declaration: the datacenter driver (which providesnvidia-smi), the DCGM host engine (nvidia-dcgm) and the DCGM Prometheus exporter (nvidia-dcgm-exporter, serving/metricson:9400). The package names are identical on apt and dnf, so the same declaration works on Ubuntu/Debian and RHEL/Rocky; pair it with a CUDAapt_repository/yum_repositoryfor the packages to install from, then point Prometheus at<host>:9400. Knobs:cuda_major(default"12"),driver(default on),statepresent|absent. Health reports Degraded if the DCGM engine or exporter is down, so a crashlooping unit is not reported healthy. Seeexamples/repo/groups/gpu/nvidia.yaml.
Changed
- The public site now stays in lockstep with releases automatically: the
hostcd.devchangelog page is generated from this file and the pinned install version on the landing and README is bumped on every release, so neither drifts from the shipped version again.
[0.3.18] — 2026-11-11
Added
- Read-only mode (
-read-only) — the server refuses every mutating request with a clean JSON403and advertisesreadOnly:truein the session, while the UI gates its write controls (the "New folder" button and other mutations are hidden for a read-only session). The agent poll is a token-authedPOSToutside the session-auth wrapper, so agents keep reconciling. Two companion flags shape the read-only banner:-read-only-notesets the reset-cadence sentence and-read-only-linkrenders a "Learn more →" link. This is what powers the public anonymous demo.
Security
- Toolchain bumped to Go 1.26.11 — picks up the
net/httpfix for GO-2026-6859. - Fresh installs authenticate
/metricsby default —install.shnow generates aHOSTCD_METRICS_TOKENon first install, so a new server requires a bearer token to scrape metrics (remove the line inserver.envto open it on a trusted network). A server started manually without the token still leaves/metricsopen, as documented in the threat model. - The release fails if a required artifact is missing — including the Windows
agent — so
sha256sum -ccan no longer verify a release green while an artifact that silently failed to build is simply absent fromSHA256SUMS.
Fixed
- The modal/drawer scrim is now a neutral black, so it visibly dims the content behind it on the dark theme (it previously matched the dark page background and dimmed nothing).
- Truncated commit messages in the UI now show the full message in a tooltip.
Docs
- Backup/restore runbook with explicit RPO/RTO in the operations guide; an RDP
runbook for moving an SSH-less Windows agent to a per-host token; a top-level
ROADMAP.md(now/next/later); a repoCLAUDE.md; and a roadmap-wording fix (approval gates / notifications / audit export are Team, not Enterprise).
[0.3.17] — 2026-11-10
Added
- Mint a per-host agent token for an existing host —
POST /api/hosts/{name}/token(admin-only, audited). Per-host tokens were previously minted only by install-over-SSH, so a host with no SSH path (a Windows agent, or an air-gapped host) could not be moved off the shared enrolment token. The new endpoint mints a fresh per-host token, clears any revocation, persists the new digest before returning it, and returns the plaintext once — paste it into the agent's config and restart. It also rotates an existing per-host token. Minting invalidates the host's previous token immediately, so the agent is briefly offline until it is reconfigured with the new token.
[0.3.16] — 2026-11-09 — reliability & HA hardening
Security
- Fixed a reload-path panic (DoS): a config reload that produced a nil result set could panic the server; reload is now nil-safe.
/metricsno longer holds a lock across network I/O — the snapshot is taken under the lock and written without it, closing a lock-contention/DoS window. (Operators on a public address should still set-metrics-token;/metricsis unauthenticated by default.)
Changed (HA — Enterprise preview)
- Leader election now demotes fail-closed on a failed lease acquire/renew
instead of keeping leadership until a later success (removes an unbounded
split-brain window);
pgElector.releaseerrors are surfaced, not swallowed. - A standby reloads its cache after a LISTEN reconnect, so a
NOTIFYmissed during a connection outage is still caught. - Write-forwarding to the leader trusts system roots plus a configurable
-peer-ca/HOSTCD_PEER_CAbundle (fixes self-signed peer TLS; never skips verification, fails closed) and retries once against a fresh leader URL when nothing has been written yet; an undeliverable forward returns503+Retry-Afterrather than a hard502. - HA remains an Enterprise preview pending a multi-day two-node soak.
Fixed
- The server refuses a server-side install from a stale
-agent-dist(prevents a silent agent downgrade) and warns at startup on a version mismatch.
Added
deploy/install.shcan auto-populate-agent-distwith cosign/SHA256SUMS- verified agents in lockstep with the server version (opt-in viaHOSTCD_AGENT_DIST; platforms viaHOSTCD_AGENT_DIST_PLATFORMS), re-staged on every install/upgrade. The host drawer now shows server / hosted-dist / installed agent versions and flags drift.
Internal
- Test coverage for
Package/Service.Apply, engineRun/Trigger/Snapshot, the git source, and license removal; an HA fault suite (partition fail-closed demote, LISTEN-reconnect re-signal). CI now fails (not skips) Postgres tests when its DSN is missing, adds an embedded-key SSO end-to-end check, and the RUSTSEC-2024-0429 glib ignore self-expires once glib reaches ≥ 0.20.
[0.3.15] — 2026-11-08 — security release
Security
- High: fixed an app-destination label-scope bypass — a per-host agent token could read another scope's secret-bearing manifest by reporting crafted labels. Destination matching now uses admin-assigned labels only (frozen after enrolment; clears persist across restart/HA). Upgrade is recommended.
- Medium:
GET /api/auditis now admin-only (was readable by scoped viewers). - Low:
GET /api/events(SSE) no longer leaks out-of-scope resource names to scoped viewers. - Hardening: resource exec sinks reject option-injection in package/service/user/group names.
- Desktop:
tokio→ 1.54.1;cargo-auditnow runs in required CI.
Added
- Windows agent
hostcd-agent-windows-amd64.exepublished in releases (late beta;package/file/service). Seedocs/WINDOWS.md. - UI: view and edit a host's admin-assigned targeting labels.
Fixed
- Documentation consistency (pricing/trial wording); self-contained public release notes.
[0.3.14] — 2026-11-07
Security
- Bumped
golang.org/x/oauth2to v0.27.0 (CVE-2025-22868).
Changed
- Licensing docs reconciled to monthly pricing and the honest source-availability status; added CI docs-consistency and site-consistency guards.
This page is also available as Markdown, indexed in llms.txt for AI assistants.