Mysterium CLI
Andzej Korkuz avatar
Written by Andzej Korkuz
Updated over a week ago

Myst CLI is a command line interface that allows you to manipulate a Mysterium node using just your terminal.

To get familiar with myst cli usage follow the below guide which explains initial set up and available commands for node operators. Mysterium CLI allows you to create, unlock & register node identity, claim your node into, set bounty payout address, view NAT Traversal status & NAT type, check healthcheak, manually start/stop WireGuard service and more.

How to use the CLI

Linux: open your terminal and execute:

myst cli

Docker: open your terminal and execute:

docker exec -it myst myst cli

Once started your terminal window should change to the myst cli interface. To get help and see a full list of possible commands execute:


Each command has an output, if the output does not start with [ERROR] or [WARNING] consider that command a success.

Commands can be autocompleted using the tab key on your keyboard.

Initial setup

If you have already installed a Mysterium node but have no access to the NodeUI to complete the onboarding process, you'll have to unlock and register your identity with Mysterium CLI. Go ahead and fire up the cli application and follow the steps below.

Check your identity

In order to identify yourself in the network you must have an identity which was created during the installation process. Use the command below to print your node identity address to your terminal.

identities list

Unlock the new identity

identities unlock

In order to use the created identity it has to be unlocked first.

Note! Unlocking has to be done every time we launch the myst cli and want to use the created identity.

For the sake of simplicity let's say we've received an identity:

0x4570fe47a49af9ae9bd76f029818413ea18620000, which we'll use in all later steps.

To unlock it we'd have to execute:

identities unlock 0x4570fe47a49af9ae9bd76f029818413ea18620000

Register your identity

After creating and unlocking the identity it must be registered so that Mysterium services are aware about it and it's balance, to do that execute the identities register command.

identities register [beneficiary]

Optional field [beneficiary] can be provided. If provided withdrawal will be automatic and will be sent to provided beneficiary wallet on each settlement.

Claim your node into

mmn [api-key]

Note: You can find and copy your API key in your Mystnodes profile.

Set payout wallet address

Note! Not required if beneficiary is set as withdrawals will be automatic.

identities set-payout-address

There are two types of wallets that you can use:

Get payout wallet address

Ensure that beneficiary wallet address has been successfully changed:

identities get-payout-address

Withdraw earned MYST

Note! Not required if beneficiary is set as withdrawals will be automatic.

You can use the CLI to withdraw MYST you've earned. Make sure your identity is unlocked and check your balance and earnings:

identities get

(Optional) The amount which you can withdraw will be displayed as your balance. Your earnings are periodically settled in to your balance. If you want to settle earnings in to balance yourself (it will cost you a certain amount MYST in fees), you can do so by running:

identities settle

After that's done you can now withdraw your funds using the withdraw command:

identities withdraw [amount]

You can withdraw funds to:

  • 137 (Matic mainnet)

    Set beneficiary for automatic withdrawals

Automatic withdrawals can be enabled by setting your beneficiary address not to be equal to your channel address. Doing so requires you to have unsettled balance as a transaction to change the address is also a settlement.

To change your beneficiary execute:

identities beneficiary-set

To view the status of your beneficiary transaction and your current set beneficiary execute:

identities beneficiary-status

Managing node service

To start WireGuard service we'd have to execute (note that WireGuard service is started automatically upon installation, therefore you don't need to start it manually):

service start wireguard

To stop WireGuard service:

service stop wireguard

To get ID and status of your currently active service:

service list

If you are seeing the similar output to the one below - your service is up and running!

[Running] ID: 7b4652a8-2021-4b9d-aeea-da7a60709678 ProviderID: 0x00f735d4ad380b56b92cd6c9f078763bbfeab3e8 Type: wireguard

To get a list of sessions:

service sessions

To get NAT Traversal status and NAT type:


To view your current node version and uptime execute:

Did this answer your question?