Migration Copy

Upgrading BetterContext

Updating SDK libraries, command-line binaries, MCP server versions, and self-hosted database schemas.

BetterContext adheres to strict Semantic Versioning (SemVer MAJOR.MINOR.PATCH). Upgrades within the same major version maintain backwards compatibility across all REST endpoints and graph storage formats.

Checking your Current Version

Verify your installed CLI and SDK version:

bettercontext --version

Updating Tools & SDKs

Run the package update command for your environment:

Homebrew CLI (macOS / Linux):

brew update && brew upgrade bettercontext

Python SDK:

pip install --upgrade bettercontext

Node.js / TypeScript SDK:

npm install @bettercontext/sdk@latest

Global MCP Server (npx):

# Clear npx cache to pull the latest MCP server build
npx clear-npx-cache
bettercontext mcp update

Self-Hosted Upgrades & Migrations

If running BetterContext via Docker Compose or Kubernetes Helm charts:

# Pull latest container images and apply schema migrations
docker compose pull
docker compose run --rm api bettercontext migrate
docker compose up -d

Release Notes & Deprecations

View the complete release notes, feature updates, and bug fixes on the official Changelog.

Next Steps

Was this page helpful?

ON THIS PAGE

Overview
Checking Version
Updating Tools & SDKs
Self-Hosted Migrations
Release Notes
Next Steps