Repository navigation
Releases
Pebble v1.33.2-fips: Prometheus metric counter rename, plan validation fixes, and Go 1.27.3
Pebble v1.33.2-fips is a FIPS-compatible release that brings in fixes and updates from upstream Pebble v1.33.1 and v1.33.2.
Breaking Changes
- Prometheus metric counter names (
_totalsuffix): Metric counters exposed at/v1/metricsnow use the Prometheus/OpenMetrics standard_totalsuffix instead of_count(#1124). Existing queries, alerts, and dashboards should be updated:pebble_service_start_count→pebble_service_start_totalpebble_check_success_count→pebble_check_success_totalpebble_check_failure_count→pebble_check_failure_total
Bug Fixes
- Plan validation: Appending a layer that fails plan validation (such as with
pebble add --inner) no longer mutates the live plan layers in place (#937). - Check period validation: Plan validation now rejects non-positive (zero or negative) check
periodandtimeoutvalues, preventing runtime panics (#1126). - Metrics type validation: Invalid or out-of-range metric types are now rejected with an error instead of causing formatting panics (#1118).
- Terminal input flags: Set
termiosinput flags (IMAXBEL,IUTF8,BRKINT,IXANY) onIflagrather thanCflagwhen opening ptys in devpts, fixing UTF-8 multi-byte character deletion and input handling (#1115). - Service log prefix stripping: Handled closing brackets (
]) within service names when stripping log line prefixes for task logs (#1129). - TLS identity certificates: Handled non-Ed25519 public keys in identity certificates gracefully without panicking (#1120).
- CI release workflow: Added a fallback to
cmd/version.gowhencmd/VERSIONis absent in release workflows (#1108).
Documentation & Maintenance
- Updated Go toolchain to Go 1.27.3, addressing standard library security vulnerabilities (#1122, #1140).
- Added a complete structured index to the documentation homepage (#1123).
- Updated Rockcraft documentation links to the new URL (#1133).
- Updated GitHub Actions and dependency versions (#1112, #1113).
v1.33.2: Update Go to 1.27.3
Updated the Go toolchain to Go 1.27.3 (#1140) to address upstream standard library security vulnerabilities.
Full Changelog: v1.33.1...v1.33.2
v1.33.1: Standardised metric names, plan and PTY fixes, and Go 1.27.2
Pebble's counter metrics have been updated to adhere to Prometheus and OpenMetrics naming conventions by replacing the _count suffix with _total (#1124). Counter metrics are now exposed as:
pebble_service_start_total(waspebble_service_start_count)pebble_check_success_total(waspebble_check_success_count)pebble_check_failure_total(waspebble_check_failure_count)
Note
This is a breaking change for metric consumers. Existing dashboards, alerts, and queries that refer to the previous *_count metric names should be updated to use *_total.
Plan state and check validation fixes:
- Appending an inner or sub-directory layer (
pebble add --inner) that fails plan validation now leaves the daemon's live plan unchanged (#937), preventing partial layer mutations from persisting after validation errors. - Plan check validation now rejects negative
periodandtimeoutduration values (#1126), preventing panics when invalid durations were passed totime.NewTicker.
Logging, PTY, TLS, and metrics fixes:
- Service log prefix stripping in task failure logs now correctly handles service names containing
]characters (#1129). - In
ptyutil.OpenPtyInDevpts, termios input flags (IMAXBEL,IUTF8,BRKINT,IXANY) are now set onIflagrather thanCflag(#1115). This ensures multi-byte UTF-8 character erasure in cooked mode, properSIGINTgeneration on break conditions, and output restart behaviour. - Fixed a panic in TLS identity certificate validation when checking certificates with non-Ed25519 public keys (#1120).
OpenTelemetryWriter.Writenow validates metric types before emission and rejects invalid types with an error rather than panicking during formatting (#1118).
Build, documentation, and dependencies:
- Updated the Go toolchain to Go 1.27.2 (#1122) to resolve upstream standard library security vulnerabilities.
- Updated
golang.org/x/sysandgolang.org/x/termdependencies (#1112). - Added a complete index and table of contents to the documentation homepage (#1123) and updated Rockcraft documentation links (#1133).
- The release workflow now falls back to reading
cmd/version.gowhencmd/VERSIONis absent on older release branches (#1108).
Full Changelog: v1.33.0...v1.33.1
v1.33.0-fips: Outdated service notes and numerous fixes
Pebble v1.33.0-fips Release Notes
Pebble v1.33.0-fips is the FIPS-compliant release corresponding to upstream Pebble v1.33.0. This release introduces service status notes (outdated flag) in the CLI and API, replaces gorilla/mux with Go's standard library net/http.ServeMux for daemon routing, and delivers extensive stability, validation, and concurrency fixes.
v1.33.0: Outdated service notes and numerous fixes
pebble services now displays a Notes column (modelled after snapd's convention) and supports the outdated note (#946). When a running service's plan configuration or workload definition has diverged from the active plan, pebble services displays outdated (or - when running the current plan). The daemon REST API and Go client also expose the corresponding outdated boolean field.
The daemon API routing has been refactored to replace gorilla/mux with the Go standard library net/http.ServeMux (#954), eliminating an external dependency while streamlining daemon routing.
Daemon shutdown ordering has been fixed by stopping the overlord before calling http.Server.Shutdown (#948). This eliminates a 1-second delay and spurious context deadline exceeded error on shutdown when exec commands or long-polling requests are in flight. Additionally, the process reaper now configures signal handling during Start to remove the race window where child exit signals could be missed (#933).
Several fixes and improvements have been made to service logging and metrics:
- Service log ring buffers are now closed when a service process exits or is stopped during backoff (#925), unblocking log iterators and allocating fresh buffers on restart.
- Existing log pullers and iterator positions are now preserved across plan updates, preventing lost log entries when modifying plan layers (#1081).
servicelog.RingBufferand its iterators now safely prevent nil pointer dereference panics when iterators are closed duringNextorBufferedcalls (#1090), returnio.ErrShortWriteon short writes inWriteTo(#1091), and reject negative lengths inDiscard(#1092).LastLinesnow preserves leading line indentation and internal whitespace rather than trimming it (#1089).- Prometheus and OpenMetrics exposition data is now validated and escaped, rejecting malformed names, invalid UTF-8, and unsupported control characters (#1075).
WebSockets, command execution, and PTY handling have been improved:
ReaderToChannelnow supports cancellation on client disconnects from non-PTY exec streams, preventing leaked producer goroutines (#1099).ExecReaderToChannelsynchronizes channel closing and flushes pending buffered output on hangup (POLLHUP), avoiding channel send panics on slow consumers and dropped trailing output (#1093).- Task WebSocket endpoints now prioritize already-ready change errors over WebSocket upgrades, consistently returning internal task errors rather than 400 Bad Request responses (#1097).
- Duplicate WebSocket connections for the same execution are now rejected and closed after upgrade (#1079).
ptyutil.SetSizenow validates terminal dimensions to fit withinuint16bounds (#1088), andptyutil.OpenPtyInDevptshandlesOpenaterrors promptly while closing peer file descriptors on failure (#1087).- The deprecated
github.com/pkg/termdependency has been replaced withgolang.org/x/term(#951).
Plan validation and state handling have been hardened:
- Plan validation now rejects
Hostheaders in HTTP check configurations (#1078), non-finite (NaN/Inf)backoff-factorvalues (#1085), empty log-target names (#1086),service.namelabels for OpenTelemetry log targets (#1082), and whitespace-only check commands (#1076). State.Prunenow marks the state modified when removing expired, obsolete, or trimmed notices so cleanups persist across restarts (#1083), andState.AddNoticecopies user IDs and data maps to prevent state mutation after recording (#1084).Identity.Validatenow formats invalid-name errors with the supplied name rather than stale stored names (#1080).cmdstate.Execnow validates that the command slice is non-empty (#1077).- Accepted Unix connections are now closed immediately if peer credential lookup fails (#1072), and
POST /v1/servicesvalidates requested actions earlier (#1073). SetAppIDin the logger package is now synchronized underloggerLockto prevent data races with concurrent security logging (#1074).
Go client library updates:
- Log streaming now returns an error on unterminated lines at EOF instead of silently dropping data (#1066).
- Client methods (
Health,Checks,ListFiles,Logs,FollowLogs) now safely acceptniloption pointers (#1055). - File permission strings with extra octal bits outside
0777are now rejected (#1062). - Removed redundant
Decoder.More()check inDecodeResult(#1054).
Build and packaging changes:
- Pebble now embeds
cmd/VERSIONvia//go:embedinstead of generating Go source files during builds (#1071). - Combined repeated
-ldflagsoptions in Snapcraft build overrides so-wand-sflags are both applied (#1102). - Documentation updates clarify pure-Go user and group resolution limitations on NSS-managed systems (#943) and improve discoverability of health check guides (#931).
- Updated the Go toolchain to Go 1.27.1 (#953).
Full Changelog: v1.32.2...v1.33.0
v1.32.2-fips: FIPS release with Go 1.26.6, release automation, and CI improvements
Pebble version v1.32.2-fips is a FIPS 140 release tracking upstream Pebble v1.32.2.
Changes
v1.32.2: Release workflow automation and Go 1.26.7 bump
The release pipeline has been refactored to automate each stage of the release process, including version bumps, release notes generation, binary and snap builds, and FIPS branch synchronization (#928).
A basic workshop dev environment setup with Go and the Pi.dev agent harness has been added (#912).
This release also updates the Go toolchain to 1.26.7 (#923) and updates dependencies golang.org/x/sys and golang.org/x/term (#915).
Full Changelog: v1.32.1...v1.32.2
v1.32.1: use Go 1.26.5
This release is a patch release that bumps the Go version to 1.26.5 to fix a CVE (GO-2026-5856), as well as bumping versions for other dependencies and build dependencies.
Full Changelog: v1.32.0...v1.32.1
v1.32.0-fips: Structured output for version and health, read-only filesystem fix
Note
This is the FIPS version of the v1.32.0 release, and has identical changes to that release, but remains stripped of all cryptography code.
pebble version and pebble health now support --format json and --format yaml flags for machine-readable output (#880). When using a structured format, pebble health no longer exits with a non-zero code when health checks are failing — callers can inspect the structured output directly.
Two goroutine leaks have been fixed: one in CommandManager.Connect when a request context is cancelled (#869), and one in the HTTP client retry loop when a context cancellation and retry timer fire simultaneously (#876).
armhf builds have been restored and other architecture builds re-enabled in the release pipeline (#886). This release also updates the Go toolchain to 1.26.4 (#881).
Full Changelog: v1.31.0...v1.32.0
v1.32.0: Structured output for version and health, read-only filesystem fix
pebble version and pebble health now support --format json and --format yaml flags for machine-readable output (#880). When using a structured format, pebble health no longer exits with a non-zero code when health checks are failing — callers can inspect the structured output directly.
Pebble now emits authz_fail security audit events when a client certificate fails verification during identity lookup and MTLS pairing (#874).
Two goroutine leaks have been fixed: one in CommandManager.Connect when a request context is cancelled (#869), and one in the HTTP client retry loop when a context cancellation and retry timer fire simultaneously (#876).
pebble run previously always generated or loaded an identity key under $PEBBLE/identity, even when --https was not configured and the key would never be used — causing failures on read-only filesystems. The identity key is now only generated when HTTPS is enabled (#896).
armhf builds have been restored and other architecture builds re-enabled in the release pipeline (#886). This release also updates the Go toolchain to 1.26.4 (#881).
Full Changelog: v1.31.0...v1.32.0