# Installation

## 1. Running The Node

* Before installing a Pion node, one needs to install Docker. To do so, you can use [Install Docker Engine](https://docs.docker.com/engine/install/#server), where you should first choose your server's operating system, and then follow the installation instructions. 
* If you already have an ALICE node and are migrating to Pion, first stop and remove your old node by running the following commands on your server (one by one):

```
docker stop muon-node mongo redis
docker rm muon-node mongo redis
```

* The first step is to get the Pion `docker-compose.yml` . To do so, run the following command on your server: 

```
curl -o docker-compose.yml https://raw.githubusercontent.com/muon-protocol/muon-node-js/pion/docker-compose-pull.yml
```

* And then you call pull images using this command:

```
docker compose pull
```

* Now the node can be run using the following command.

```
docker compose up -d
```

* Wait for a minute and then run the next command and see the result. 

```
curl http://localhost:8012/status
```

{% hint style="info" %}
The result should look like this and means your node is running properly. (It is not added to the network yet.)\
\
{"address":"0x22E25482F7B27b8765FE93F4ac0Cb79a0e8cB3ef","peerId":"QmVZrfc47AQQoPGjbWAmd1wQv9BtGYpFQ67JnbFmmHxAWN","networkingPort":"9012","node":{"addedToNetwork":false,...}}\
\
You need this `address` and `peerID` later when you add the node to the network.

But if you see the message `curl (7) failed connect to localhost:8012 connection refused` , refer to [this FAQ](broken://pages/G4uAZ7VbC0weTp9HGRnU#when-i-run-curl-http-localhost-8012-status-i-see-this-error-message-curl-7-failed-connect-to-localho). 
{% endhint %}

***

## 2. Acquiring bonPION

* If you are eligible for the bonPION node-drop, you first need to refer to the [Claim the Node-Drop](broken://pages/a36mKPNC8GKIyeTX0v8s) section and follow the steps. Having claimed it, move on to [section 3](#3-adding-the-node-to-the-network) on this page.
* If you are a new user, you need to refer to [Pion dashboard](https://app.muon.net/pion/getting-started) and click on Buy Pion. Follow the steps through.

<figure><img src="/files/FWHBRibPwRbuCK9BwztY" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To run a tier1 node, you need at least 500 bonPIONs. Having bought that, click on the  "Create Bonded Pion" to create your NFT. Then move on to [section 3](#3-adding-the-node-to-the-network) on this page.

<mark style="color:orange;">**NB:**</mark> Having created your bonPION, you can [boost your NFT](https://docs.muon.net/muon-network/muon-nodes/pion/upgrading-bonpion-nfts) to earn higher rewards.&#x20;
{% endhint %}

***

## 3. Adding the Node to the Network

* After you have gone through the steps in sections 1 & 2, refer to [Pion dashboard](http://app.muon.net/pion/getting-started). connect your wallet and click on "Set up Node".

<figure><img src="/files/8pbYKWDlylYPUQ72R8Ob" alt=""><figcaption></figcaption></figure>

* Your are forwarded to the next page. Click on "Select".

<figure><img src="/files/EN8IX0GLkFaUuvOOva53" alt=""><figcaption></figcaption></figure>

* A popup opens showing the amount of your bonPION. Click on the popup.

<figure><img src="/files/helbbVlqe3vVtL3y366o" alt=""><figcaption></figcaption></figure>

* On the next page, you can see your NFT info in the left-hand box. In the right-hand one, enter your Node Address and Peer ID (explained in section 1).

<figure><img src="/files/0lE7RMUCMxWJ6E1r75FQ" alt=""><figcaption></figcaption></figure>

* Having entered Node Address and Peer ID, click on the "Approve" and confirm the message on your wallet. Now the "Add Node" button appears. Click on it and confirm the transaction on your wallet.

<figure><img src="/files/21dvJKBPrm3BWWN2eOYF" alt=""><figcaption></figcaption></figure>

* Wait for the success message in the right-hand bottom corner.&#x20;

<figure><img src="/files/o0E6cdlYaJba2UangGgO" alt=""><figcaption></figcaption></figure>

* Having added the node successfully, you will see the following page for a few minutes.&#x20;

<figure><img src="/files/4kwTQs917lEfu1pJ0JV4" alt=""><figcaption></figcaption></figure>

* When you see the following dashboard, you have successfully joined Pion network.

<figure><img src="/files/NULnMG3MWJPewuH7tHHj" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %} <mark style="color:orange;">**VERY IMPORTANT**</mark>: Make sure you have [backed up your node](broken://pages/pBHPl7NYsatb7ZPE8MA7) as soon as you add it. In case something happens to your server, you can use the backup to restore your node. Not backing up your node may result in financial loss.
{% endhint %}

* Now you should go through [uniqueness verification](broken://pages/Krf9sANhPs6R5v90pIRh) and register your node with the [Pion Nodes bot](broken://pages/p0NV0xrjdKDUHJHbUYUd) on Muon Discord channel.&#x20;


---

# Agent Instructions: 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.logosnodos.online/mainnet-node/muon-network/installation.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.