This document explains how to run locally Juno.
Before you begin developing and contributing to Juno, ensure the following tools are installed on your machine:
- NodeJS (Website)
- Rust and Cargo (Installation)
- Docker (Windows, MacOS, or Linux).
- Clone the repository and install dependencies:
git clone https://github.com/junobuild/juno
cd juno
npm ciTo start Juno locally, perform the following steps:
- Start the emulator: This command runs a local emulator that replicates the behavior of the Internet Computer blockchain, deploying necessary smart contracts using a custom Docker image (repo) developed specifically for Juno.
npm run emulator
- Launch the front-end administration console: Open another terminal window and start the console, which is configured to interact with the emulator.
npm run dev
Both the emulator and the front-end server support live reloading, facilitating a smoother development experience.
You can manually build the smart contracts using standard Rust and Cargo commands targeting wasm32-unknown-unknown. For example:
cargo build --target wasm32-unknown-unknown -p console --release
However, these commands do not instruct the emulator to redeploy the resulting builds. Therefore, to automate both build and deployment, we provide the following npm commands:
npm run build:console
npm run build:observatory
npm run build:satellite
npm run build:mission-control
npm run build:orbiter
Here are a few commands that can be useful if you spend some time developing and contributing features for Juno:
| Command | Description |
|---|---|
npm run ledger:transfer |
Transfer 55 ICP to a Mission Control aka Wallet. |
Go to Candid releases page to download your OS version didc.
Example, for macos
release=$(curl --silent "https://api.github.com/repos/dfinity/candid/releases/latest" | grep -e '"tag_name"' | cut -c 16-25)
curl -fsSL https://github.com/dfinity/candid/releases/download/$release/didc-macos > ~/.cargo/bin/didc
chmod 755 ~/.cargo/bin/didccargo install candid-extractor