Skip to main content

Upgrade: v1.0.8 to v1.1.0

Migration guide for upgrading ɳSelf CLI from v1.0.8 to v1.1.0.

v1.0.9 is a non-breaking release. No commands were removed. No env vars were deleted. Most users can upgrade with a single command.

Quick upgrade

brew upgrade nself
# or
nself update

Verify the upgrade:

nself version
# nself v1.1.0 ...

What changed

New features

  • Deprecation warning system: CLI now warns on deprecated items via stderr.
  • Plugin SDK Go v0.1.x, new module path, backward compatible with v0.0.x behavior.
  • API sunset dates: Sunset response headers on all API surfaces.
  • Ecosystem-wide deprecation cycle doctrine, 3-phase cycle for all surface types.

Signal table

Signal typeOld valueNew valueMigration action
Plugin SDK module pathnselfgithub.com/nselfUpdate go.mod (plugin authors only)
Bundle namenMedianselfRe-install: nself plugin install nTV
Hasura nselfColumn active@deprecated: EOL 2027-04-17Use device_type + device_name

No CLI commands, flags, or env vars changed.

Plugin SDK migration (plugin authors only)

If you maintain a custom plugin and used the old nself package:

go get github.com/nself-org/nself_plugin_sdk@none
go get github.com/nself-org/plugin-sdk-go@v0.1.0
go mod vendor

Update your import:

// Before
import sdk "github.com/nself-org/nself_plugin_sdk"

// After
import sdk "github.com/nself-org/plugin-sdk-go"

nMedia → ɳTV bundle rename

The media bundle was renamed from nMedia to nself to align with the ɳTV companion app.

nself plugin install nTV

All underlying plugins (streaming, epg, tmdb, media-processing, recording, etc.) are unchanged.

Hasura schema change (GraphQL consumers only)

The nself column is now @deprecated. It continues to return data through the support window (until 2027-04-17), after which it will be removed in v1.2.0.

# Deprecated, still works until v1.2.0
{ nself_sessions { user_agent } }

# Use instead
{ nself_sessions { device_type device_name } }

Verifying your upgrade

Run the built-in doctor after upgrading:

nself doctor

All checks should pass. If any plugin reports a compatibility warning, run:

nself plugin compat-check

Next