Skip to main content

Setup

This guide will help you set up Calimero in your device.

There are two main paths:

  1. Install via Script or Homebrew (Recommended): Quickly install merod for most users.
  2. Build from Source: For developers who want to contribute or modify the framework.

Supported Platforms​

Calimero currently supports the following operating systems and architectures:

  • Operating Systems: macOS, Linux
  • Architectures: x86_64, arm64 (Apple Silicon)
note

If your platform is not supported, please create an issue on GitHub.

Installation​

You can choose to install merod using either the installation script or Homebrew.

If you use Homebrew, you can install merod directly with the following steps:

Steps​

  1. Add the Calimero Homebrew tap:

    brew tap calimero-network/homebrew-tap
  2. Install merod:

    brew install merod
  3. Verify the installation:

    merod --version

If the version number appears, the installation was successful.

Next Steps​

Initialize and run node

If this is your first time initializing the node, the process may take a little bit more time until all dependencies are downloaded. It will take around 7 minutes but can vary depending on your internet connection.

1. Initialize node​

Terminal
merod --node-name node1 init --server-port 2428 --swarm-port 2528
tip

A --protocol flag defines protocol for the node contexts.

Node configuration file contains protocol defined metada. Node file is located under ~/.calimero folder.

NearConfig

2. Run node​

Terminal
merod --node-name node1 run

Wait for a few moments and node logs should appear.

Node running

When you see something like this that means that node is now ready for use.

Was this page helpful?
Need some help? Check Support page