Cedra CLI Installation Guide

The Cedra Command Line Interface (CLI) is the primary tool for developers and users to interact with the Cedra blockchain. It lets you manage accounts, deploy Move modules, test code, execute transactions, and query network state.

Prerequisites

Before installing the Cedra CLI, make sure you have:

• ✅ Installed Rust and Node.js - Required for building from source and running JavaScript/TypeScript clients

Installation

Recommended Installation Methods.

We recommend using your operating system's package manager for the easiest installation experience:

• Linux (Ubuntu/Debian): Use APT repository
• Windows: Use Chocolatey
• macOS: Use pre-built binaries until Homebrew is approved

Option 1 - Install via APT repository (Ubuntu/Debian - recommended)

Ubuntu Version

We recommend using Ubuntu 22.04 or later for the best compatibility.

For Ubuntu/Debian users, install via the official PPA:

sudo add-apt-repository ppa:cedra-network/deps
sudo apt update
sudo apt install cedra-cli

Alternatively, you can download and install the .deb file directly:

wget https://launchpad.net/~cedra-network/+archive/ubuntu/deps/+files/cedra-cli_1.0.1~noble_amd64.deb
sudo dpkg -i cedra-cli_1.0.1~noble_amd64.deb

After installation, confirm:

cedra --version

Option 2 – Install via Chocolatey (Windows - recommended)

1. Run the following command:

choco install cedra

2. Once installed, verify:

cedra --version

More details available here: Chocolatey Cedra CLI Package

Option 3 – Download a pre‑built binary (fallback option)

When to use pre-built binaries

Use pre-built binaries if:

• Your OS package manager is not available
• You're on macOS (while waiting for Homebrew approval)
• You need a specific version not available in package managers

1. Visit the Cedra CLI v1.0.1 release page: https://github.com/cedra-labs/cedra-network/releases/tag/cedra-cli-v1.0.1.
2. In the Assets section, choose the file that matches your platform:

OS	Architecture	File name
Linux	x86_64	cedra-cli-1.0.1-Linux-x86_64.zip
Linux	aarch64	cedra-cli-1.0.1-Linux-aarch64.zip
macOS	x86_64	cedra-cli-1.0.1-macOS-x86_64.zip
macOS	arm64 (Apple Silicon)	cedra-cli-1.0.1-macOS-arm64.zip
Ubuntu 22.04	x86_64	cedra-cli-1.0.1-Ubuntu-22.04-x86_64.zip
Ubuntu 24.04	x86_64	cedra-cli-1.0.1-Ubuntu-24.04-x86_64.zip
Windows	x86_64	cedra-cli-1.0.1-Windows-x86_64.zip

3. Extract the archive.

4. Move the cedra (or cedra.exe on Windows) executable to a folder that is in your PATH:

   • macOS / Linux: /usr/local/bin or $HOME/.local/bin
   • Windows: C:\Windows\System32 or any folder listed in Environment Variables → Path

macOS Security

On macOS, you may need to approve the CLI in System Settings:

1. When you first run cedra, macOS may block it as an unidentified developer
2. Go to System Settings → Privacy & Security
3. Find the blocked app notification and click "Open Anyway"
4. Alternatively, you can run: xattr -d com.apple.quarantine /path/to/cedra

5. Check current CLI version:

cedra --version

Option 4 – Build from source

If you prefer compiling yourself or contributing to Cedra:

git clone https://github.com/cedra-labs/cedra-network
cd cedra-network
cargo build --release -p cedra

The compiled binary will be at target/release/cedra (or .exe on Windows). Add it to your PATH and run cedra --version to confirm.

Option 5 – Install via Homebrew (coming soon)

info

The Cedra CLI for Homebrew is currently under review by the Homebrew community. Once approved and merged, it will be available via the standard Homebrew package manager.

What's next?

• Dive depper into the CLI - via CLI guide
• Start your write your first contract - via CLI guide
• Build your first DApp - via our Real World Guides