> For the complete documentation index, see [llms.txt](https://docs.validator247.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.validator247.com/mainnet/nockchain.md).

# Nockchain

> <https://www.nockchain.org/>

## Nockchain Mainnet (Dumbnet) Installation & Run Guide

#### 1. Install dependencies

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential clang llvm-dev libclang-dev make pkg-config git
```

Install Rust:

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
```

***

#### 2. Clone the code & prepare the environment

```bash
git clone https://github.com/zorp-corp/nockchain.git
cd nockchain
cp .env_example .env
```

***

#### 3. Build components

```bash
make install-hoonc
make install-nockchain-wallet
make install-nockchain
```

Make sure `$HOME/.cargo/bin` is in your PATH:

```bash
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

***

#### 4. Create a wallet for mining

Generate a new key:

```bash
nockchain-wallet keygen
```

📌 Save the following:

* **Public Key** (to be added to `.env`)
* **Private Key + Seed Phrase** (for backup)

Edit `.env` and set:

```env
MINING_PUBKEY=<your-generated-public-key>
```

***

#### 5. Backup/restore keys (recommended)

Export keys:

```bash
nockchain-wallet export-keys
```

Restore keys when needed:

```bash
nockchain-wallet import-keys --input keys.export
```

***

#### 6. Run mainnet node

Node only (no mining, sync only):

```bash
bash ./scripts/run_nockchain_node.sh
```

Node + Miner (mine NOCK tokens):

```bash
bash ./scripts/run_nockchain_miner.sh
```

👉 When running miner for the first time, clear old data if you previously joined testnet:

```bash
rm -rf ~/.nockchain
```

***

#### 7. Verify it’s working

* Miner logs showing:

  ```
  [%mining-on …]
  ```

  → means mining is active.
* Block logs showing:

  ```
  block … added to validated blocks at <height>
  ```

  → means your node is synced with mainnet.

***

#### 8. Notes for mainnet

* Recommended server: **8 cores CPU, 16GB+ RAM, NVMe SSD**.
* Open **P2P port 40333 (default)** to allow other nodes to connect.
* If you see `Address already in use` → change port in `.env`.
* Use **screen** or **tmux** to keep the process running after logout.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.validator247.com/mainnet/nockchain.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.