Installation

Steps to install the Movement CLI and initialize your environment.

Created: 1/11/2026

To develop and deploy Move modules, you need the Movement CLI. The following instructions are for installing the Testnet version of the CLI, which supports Move 2 and aligns with our target environment.

Installing the Movement CLI

You can install the Movement CLI using the simplified root command:

pnpm move:install

This script automatically detects your operating system (macOS/Linux) and architecture (ARM64/x86_64), downloads the appropriate binary, and adds it to your path.

Alternatively, you can run the script directly:

bash apps/move/scripts/install-cli.sh

Verifying Installation

Once installed, you can verify that the CLI is accessible by checking its version:

movement --version

It should return a version string indicating movement.

Initialization

After installing the CLI, initialize your Move environment using the simplified root command:

pnpm move:init

This script will prompt you for:

  • Network: Choose custom.
  • REST URL: Use https://testnet.movementnetwork.xyz/v1.
  • Faucet URL: Use https://faucet.testnet.movementnetwork.xyz/.
  • Private Key: Press Enter to generate a new one, or paste an existing private key.

The configuration will be saved in .movement/config.yaml.

Building and Testing

Once initialized, you can build and test your Move contracts:

# Build all Move contracts
pnpm move:build

# Run all Move contract tests
pnpm move:test

These commands use the Movement CLI under the hood to compile and test your Move modules.

IntroductionGig Contract