# Meshery v1.0.6

2026-04-09 · [Original release notes](https://github.com/meshery/meshery/releases/tag/v1.0.6) · [Full summary](https://ratatosk.io/en/releases/meshery/v1.0.6)

Breaking changes 4 · Important fixes 9 · Enhancements 3 · Dependency updates 2 · Other changes 20

## Breaking changes (4)

### `mesheryctl` adapter commands now return errors

- Affects: `mesheryctl` adapter commands (Inferred)

Previously, errors in configuration lookup, adapter or mesh validation, operation requests, or watched-operation responses were logged and the command returned nil. The affected paths now return the error; deploy, remove, and validate stop their spinner before returning operation errors.

> - fixes: return error properly adapter  @Omkar-Ugal (#18391)

### Error returned by `mesheryctl design apply` for empty-pattern responses

- Affects: `mesheryctl design apply`

When its response contained no patterns, the command logged `ErrDesignNotFound(patternName)` and returned nil.

Evidence: “if len(response.Patterns) == 0 { - utils.Log.Error(ErrDesignNotFound(patternName)) - return nil + return ErrDesignNotFound(patternName)” https://github.com/meshery/meshery/pull/18436

> - fix: design uses meshkit error properly + return error properl @Omkar-Ugal (#18436)

### `mesheryctl system restart` rejects positional arguments

- Affects: `mesheryctl system restart` calls with positional arguments

Previously, a call with one positional argument passed the runtime check; it now fails `Args` validation with `utils.ErrInvalidArgument`.

Evidence: “Args: func(cmd *cobra.Command, args []string) error { + if len(args) > 0 { + return utils.ErrInvalidArgument(” https://github.com/meshery/meshery/pull/18359

> - [mesheryctl] system restart uses meshkit error properly + remove logrus @rishiraj38 (#18359)

### `mesheryctl system restart` now returns lookup and component-check errors

- Affects: `mesheryctl system restart`

Previously, configuration lookup errors and errors checking whether Meshery components were running were logged and the command returned nil. The command now returns the configuration error directly and wraps the component-check error in `ErrRestartMeshery`.

Evidence: “running, err := utils.AreMesheryComponentsRunning(currPlatform) if err != nil { - utils.Log.Error(err) - return nil + return ErrRestartMeshery(err)” https://github.com/meshery/meshery/pull/18359

> - [mesheryctl] system restart uses meshkit error properly + remove logrus @rishiraj38 (#18359)

## Important fixes (9)

### [Silent failure] Remote persistence of authenticated user events fixed

- Affects: authenticated user-request handler events sent to a remote provider

Handlers previously passed nil to `PersistEvent`, which selected `GlobalTokenForAnonymousResults`; remote providers rejected that token with HTTP 401, silently dropping the events. Handlers now pass the request's user token, allowing the events to be persisted remotely.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### [Silent failure] Local persistence for system events and empty-token calls

- Affects: system-initiated event handling and `PersistEvent`

Previously, system-initiated events without a user request context had no dedicated local-persistence method, and calls without a usable token used an anonymous token that the remote provider rejected, so events could be silently lost. These system events can now be persisted with `PersistSystemEvent`; empty-token `PersistEvent` calls fall back to the local DB instead of remote persistence.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### Concurrent `seededUUIDs` appends synchronized in `SeedContent`

- Affects: server setups that concurrently seed content through `DefaultLocalProvider.SeedContent`

Previously, outer goroutines—and inner Pattern-case goroutines—could append to the shared slice at the same time without synchronization.

> - Server: fix import ordering and seededUUIDs data race in UUID transition follow-up @yi-nuo426 (#18583)

### Nil user lookup handling fixed in `GetUserByIDHandler`

- Affects: user lookups handled by `GetUserByIDHandler`

When `GetUserByID` returned nil, the handler could dereference the nil response while writing it. It now returns HTTP 404 with a "user not found" message in that case.

> - fix: return 404 when GetUserByID returns nil response @arjunmehta-git (#18605)

### `K8sFSMMiddleware` nil-ID panic fixed

- Affects: `K8sFSMMiddleware` handling Kubernetes contexts

When the middleware processed a context with a nil `KubernetesServerID`, including in-cluster deployments or partial cluster registration, it panicked. It now skips that context and continues.

> - fix: guard against nil KubernetesServerID in K8sFSMMiddleware @mango766 (#18600)

### Provider request body reset before token-refresh retries

- Affects: server-side provider requests (Inferred)

When a user with a fresh, valid session saved a design in their own organization and workspace, a token-refresh retry could return a 400 because the request body had been drained. The body is now restored from `GetBody` before retrying.

> - [Server] Restore body on provider retry @leecalcote (#17211)

### `persistEventRemote` response-body leak fixed

- Affects: events persisted remotely through `persistEventRemote` (Inferred)

Before this change, responses from remote event persistence left `resp.Body` open, causing connection leaks. The response body is now closed.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### Nil dereference in filter handler fixed

- Affects: filter-handler requests

When filter JSON decoding fails and `parsedBody` or its `FilterData` is nil, the handler could dereference nil. It now uses a generic corrupted-request description and returns HTTP 400 with the save-filter error.

> - fix: pass user token to PersistEvent to prevent 401 errors @marblom007 (#18595)

### Performance preferences now handle missing values and empty duration

- Affects: Performance tab in User Preferences (`/user/preferences`)

An empty `loadTestPrefs` response could leave the duration undefined and crash the tab; clearing Duration and saving could also crash. Missing values now use defaults including `30s`, and submitting an empty Duration shows a validation error instead of crashing.

> - [UI] Fix crash on Performance preferences tab @arjunmehta-git (#18587)

## Enhancements (3)

- Performance preferences accept day-based durations
- Meshery home page eligible for automatic static optimization
- Kubernetes native pod network SVG icons added

## Dependency updates (2)

2 more, none mentioning security

- `- Bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.39.0 to 1.43.0 @[dependabot[bot]](https://github.com/apps/dependabot) (#18591)`
- `- Bump go.opentelemetry.io/otel/sdk from 1.40.0 to 1.43.0 @[dependabot[bot]](https://github.com/apps/dependabot) (#18590)`

## Other changes (20)

- mesheryctl performance-result UUID fields switch to `core.Uuid`
- Direct unmarshal error handling in `design apply`
- Restart command validates its flags
- Meshery system restart guide
- Restart command status logging switched to `utils.Log.Info`
- Restart confirmation flag assignment moved
- Provider UI development coverage API route removed
- Design Configurator database-category visibility check removed
- Design Configurator end-to-end mocks updated
- Performance preferences normalized in the UI
- Meshery UI projects remove `axios` dependencies
- `useMeshModelComponents.ts` error message wording corrected
- Provider UI sub-path setting switches from `assetPrefix` to `basePath`
- Documentation Noob Tester workflow added
- GoReleaser configuration migrated to v2 syntax
- Optional `job_type` parameter for adapter test workflows
- Stable release workflow uses expression syntax for the `ctlrelease` job condition
- Import ordering corrected in seven files
- Placeholder flow titles removed from OCI models documentation
- Crawler indexing restricted for older documentation versions

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
