Trust.Supply Unofficial analytics suite Docs
Docs · Upgrade · macOS

Update trustmnw-cli to 1.2.1 on macOS

Version 2.1 · 18 Nov 2026 Needs Node 26
!

Not yet tested on a real Mac validator. The install was tried on a Mac with Homebrew Node 26 (18 Nov 2026); the nvm route follows the steps tested on Ubuntu. Try it on one Mac validator first.

i

Update one validator at a time. Open Terminal. Don't use sudo for brew, npm or trustmnw-cli.

  1. Check and back up

    which node
    trustmnw-cli --version

    Expected: a path under ~/.nvm or /opt/homebrew (Homebrew). Write the CLI version down.

    Make a backup if you can (e.g. Time Machine).

  2. Log out and stop

    trustmnw-cli logout && trustmnw-cli stop
  3. Check Node, install Node 26 if needed

    node -v

    Shows v26 or higher? Skip to step 4. Only install Node 26 if it is older or missing.

    Node from nvm (~/.nvm):

    nvm install 26
    nvm alias default 26

    Node from Homebrew (/opt/homebrew):

    brew update && brew upgrade node

    Then check node -v: expected v26.x.

  4. Install trustmnw-cli 1.2.1

    npm install -g @morpheusnetwork/trustmnw-cli@1.2.1 --loglevel verbose

    Lines keep scrolling while it works. Wait until you get your prompt back. Don't press Enter or Ctrl+C.

    rehash
    trustmnw-cli --version

    Expected: 1.2.1

    rehash makes zsh forget the old CLI location.

    Still an old version? Run which -a trustmnw-cli: if it lists /usr/local/bin/trustmnw-cli, remove that old copy with rm /usr/local/bin/trustmnw-cli (add sudo if permission is denied), then rehash again.

  5. Log in and check

    trustmnw-cli login
    trustmnw-cli status

    Log in with your KYC email and the code you receive. login also starts the node.

    Expected: node connected.

    On trust.supply the node should show online. Then move on to the next validator.

!

Moving to another server? Run trustmnw-cli logout && trustmnw-cli stop on the old one just before you run trustmnw-cli login on the new one. Never run the same validator on two machines at once.

Old machine no longer accessible? If you could not log out there: go to Trust.Supply, unlock MetaMask, connect your wallet and press Reset on Node Details (picture). Then run trustmnw-cli login on the new machine.

Keep it running

The Mac must not sleep: System Settings → Energy (laptops: Battery → Options) → turn on "Prevent automatic sleeping when the display is off", and keep a laptop's lid open.

The validator runs in the background, so you can close Terminal. Check it any time with trustmnw-cli status in a new Terminal window. After a restart of the Mac, run trustmnw-cli login again.

!

Don't accept npm's offer to upgrade npm, and don't use npm update.

To go back to the old version

If you installed Node 26 with nvm, your old CLI is still installed under Node 20.9.0. Switch back to it:

trustmnw-cli logout && trustmnw-cli stop
nvm alias default 20.9.0

Open a new Terminal window, then:

trustmnw-cli login
trustmnw-cli status

Homebrew Node: log out and stop, run npm install -g @morpheusnetwork/trustmnw-cli@<old version> --loglevel verbose, then log in.

If you reinstall the CLI on Node 20 and npm says ENOTEMPTY, first run:

rm -rf ~/.nvm/versions/node/v20.9.0/lib/node_modules/@morpheusnetwork/.trustmnw-cli-*

Based on the Masternodes Setup Guide by @trippledutch and tests of 17–18 Nov 2026 · Version 2.1 (18 Nov 2026): Node 26 only installed if missing or older; logout and stop before the install, login after it · v2.0: 1.2.1 on Node 26.