> For the complete documentation index, see [llms.txt](https://sending-network.gitbook.io/sending.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sending-network.gitbook.io/sending.network/watchdog-agent/watchdog-agent-deployment-tutorial/linux-deployment-tutorial.md).

# Linux Deployment Tutorial

Use our provided installation script to quickly launch the service with just a few commands. This script simplifies the setup process for the relay service by automating numerous configuration and installation steps. Actions performed by the script include:

* **Install prerequisites**: Installs essential tools including *Docker.*
* **Create the workplace**: Set up execution environments and download the *Docker* images.
* **Launch agent checking service**: Deploys and starts the checking service.

With these system requirements in check, you'll be well-prepared to start the deployment of your WatchDog agent.

{% hint style="info" %}
Should you encounter any issues or have questions, don't hesitate to seek support from the SendingNetwork [community](https://t.me/SendingNetworkOfficial/1).
{% endhint %}

## **Installation**

### **Step 1: Download Agent Installation Script**

Depending on your system, use the following command to download and install the deployment script:

{% tabs %}
{% tab title="Ubuntu or other Debian-based system" %}
{% code overflow="wrap" %}

```bash
sudo apt-get install -y wget && wget -N http://node4.sending.network:8120/watchdog_linux.sh  -P .
```

{% endcode %}
{% endtab %}

{% tab title="CentOS or other Red Hat-based system" %}
{% code overflow="wrap" fullWidth="false" %}

```bash
sudo yum install -y wget && wget -N http://node4.sending.network:8120/watchdog_linux.sh  -P .
```

{% endcode %}
{% endtab %}
{% endtabs %}

### **Step 2: Run the Installation Script**

Change the permissions of the script and execute the installation script by running:

{% code overflow="wrap" %}

```bash
sudo chmod 777 watchdog_linux.sh && ./watchdog_linux.sh
```

{% endcode %}

When prompted, enter your wallet address. 

{% hint style="warning" %}
Ensure you use a wallet address holding a valid License NFT. Each License NFT allows one active agent.
{% endhint %}

### **Step 3: Finish Installation**

Once enough gas is received, you'll see the following output, and your agent is up. 

```
{"wallet":"0xYourWalletAddress","status":1}
The WatchDog node is up and running.
```

If you are running the script directly, please do NOT run it with `sudo` as it will impact the agent daemon process. Instead, you can run it under a common user account, or by using sudo su or the root account.

```bash
./watchdog_linux.sh
```

***

### Check the status of WatchDog

To check if your agent is running, use the following command:

{% code overflow="wrap" %}

```sh
sudo docker ps -a | grep 'jack0818/watchdog' | grep -v grep | awk '{print $1}' | xargs sudo docker container inspect | grep '"Status": "running"'
```

{% endcode %}

If your agent is running, you will see the following output:

{% code overflow="wrap" %}

```
"Status": "running"
```

{% endcode %}

### Check your agent ID

To display your agent ID, use the following command:

```bash
cat ~/WatchdogNode/run/watchdog/peerinfo
```

### **Stop the agent**

To stop the agent, use the following commands.

1. **Find and stop the WatchDog daemon process:**

   ```sh
   sudo ps wxau | grep watchdog | grep sh | awk '{print $2}' | xargs sudo kill -9
   ```
2. **Stop and remove the Docker containers:**

   <pre class="language-sh" data-overflow="wrap"><code class="lang-sh">sudo docker ps -a | grep 'jack0818/watchdog' | awk '{print $1}' | xargs sudo docker stop | xargs sudo docker rm
   </code></pre>

### Restart the agent

To restart your WatchDog agent, follow these steps:

1. **Download the latest installation script:** In the original directory, obtain the latest script and run it.
2. **Maintain the original directory:** If you run the agent from a new directory other than the original one, it will create a new agent ID. Points will be accrued with this new ID, but previous points will remain valid under the original agent ID.

***

## Next Steps <a href="#next-steps" id="next-steps"></a>

After finishing the installation, interact with our auto-reply bot on the SendingMe app to check your agent's stats. SendingMe is an all-in-one web3 instant messaging app built on top of SendingNetwork. Refer to [Check Node Stats with Auto-Reply Bot in SendingMe](https://sending-network.gitbook.io/sending.network/edge-node-deployment-manuals/check-node-stats-with-auto-reply-bot-in-sendingme-app) for instructions on utilizing the bot to monitor your agent's performance.

Should you encounter any issues or have questions, don't hesitate to seek support from the SendingNetwork [community](https://t.me/SendingNetworkOfficial/1).