Upgrade

Upgrading Inspectr is usually a one-liner. Choose the method you originally used to install/run Inspectr.

Latest Inspectr version available

Follow the steps below to upgrade to the latest release to get the newest improvements.

Latest:

View Releases

Method you use	How upgrades work
npx	Always runs the latest version
Homebrew	`brew upgrade inspectr`
npm	`npm update -g @inspectr/inspectr`
Binary	Download a newer release and replace the existing binary
Docker	Pull the newest image and restart the container

If you run Inspectr via npx, you don’t need to upgrade. Every run downloads and executes the latest published version:

npx @inspectr/inspectr --backend=http://localhost:3000

If you want to ensure you’re not using a cached copy, clear the npx cache (optional) and run again.

Upgrade Inspectr via Homebrew:

brew update
brew upgrade inspectr

Verify:

inspectr --version

Upgrade a global npm install:

npm update -g @inspectr/inspectr

If you want to force a clean reinstall:

npm uninstall -g @inspectr/inspectr
npm install -g @inspectr/inspectr

Verify:

inspectr --version

If needed, make it executable:

chmod +x ./inspectr

Verify:

./inspectr --version

Pull the latest image:

docker pull ghcr.io/inspectr-hq/inspectr:latest

If you run Inspectr with docker run, stop/remove the old container and start a new one using the updated image:

docker run --rm -p 4004:4004 -p 8080:8080 ghcr.io/inspectr-hq/inspectr:latest

If you use Docker Compose, pull and restart:

docker compose pull
docker compose up -d

To verify the running container is updated:

docker compose ps

Explore the configuration options to tailor Inspectr to your workflow.

If something looks off after upgrading, check the release notes on GitHub and compare your current config with the latest CLI docs.