> For the complete documentation index, see [llms.txt](https://docs.mawari.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mawari.net/mawari-network-docs-japanese/mawari-economy/ndono-run-your-nodes/nogdianndowosuruserufuhosuto-run-your-own-guardian-node.md).

# 自身のガーディアンノードを実行する（セルフホスト） (Run Your Own Guardian Node)

このガイドでは、ご自身のハードウェアでガーディアンノード（Guardian Node）をセットアップして実行する手順を説明します。

#### 開始する前に

以下が準備されているか確認してください。

* ✅ Dockerがマシンにインストールされていること（下記ステップ2で手順を説明します）
* ✅ 少なくとも1つのライセンスを保有していること（ノードのアドレス［デバイス/サーバー］に割り当てるために必要です）

## ステップ 1 - システム要件の確認

| Requirement | Minimum                                             |
| ----------- | --------------------------------------------------- |
| **OS**      | Windows 10+, macOS 10.15+, or Linux (Ubuntu 20.04+) |
| **Docker**  | Docker 20.10+                                       |
| **Memory**  | 2 GB RAM minimum, 4 GB recommended                  |
| **Storage** | 5 GB free disk space                                |
| **Network** | Stable internet with outbound HTTPS access          |

ガーディアンノードは軽量です。一般的な最新のコンピュータであれば、ほとんどの場合問題なく実行できます。

## ステップ 2 - Dockerのインストール

Dockerがまだインストールされていない場合は、以下からダウンロードしてください。

* Windows / macOS: Docker Desktop
* Linux: Docker Engine

Dockerがインストールされ、正常に実行されているか確認するには、ターミナルを開いて以下のコマンドを実行します。

Bash

```bash
docker --version
```

***

## ステップ 3 - ノードの起動

ターミナルで以下のコマンドを実行します。\<your holder wallet address> の部分をご自身のステーキング済ライセンスを保有しているウォレットアドレスに置き換えてください。

Bash

```bash
docker run -d
--name mawari-node
--restart unless-stopped
-v mawari-data:/home/node/.mawari-node
-e DELEGATOR_ALLOWLIST=<your holder wallet address>
us-east4-docker.pkg.dev/mawari-chain-prod/mawari-client/guardian-node:0.2.0
```

ノードは初回起動時に、自身のアドレスとなるウォレット（「バーナーウォレット」）を自動的に生成します。これがあなたのノードアドレスとなり、次のステップで必要になります。

ノードアドレスを確認するには、以下のコマンドを実行します。

Bash

```bash
docker logs mawari-node 2>&1 | grep "Burner wallet"
```

## ステップ 4 - ノードへの資金追加 ＆ 割り当てオファーの作成

ステップ3のログからノードアドレス（バーナーウォレット）をコピーし、次の2つの作業を行います。

1. ノードへの資金追加： ネットワーク上でのガス代（手数料）をカバーするため、ノードアドレスに理想としては 0.1 $MAWARI、最低でも 0.05 $MAWARI トークンを送金します。
2. 割り当てオファー（Assignment Offer）の作成： \[Assign Operator] タブに移動し、ご自身のライセンスからノードアドレスへの「割り当てオファー」を作成します。

作業は以上です。割り当てが有効になると、ノードは自動的にオファーを受け入れ、ハートビート（生存信号）の送信を開始します。これ以上の操作は必要ありません（反映には数分かかる場合があります）。

## ステップ 5 - ノードの監視

```bash
docker logs -f mawari-node

# Check that the node is running
docker ps | grep mawari

# Stop the node
docker stop mawari-node

# Restart the node
docker start mawari-node

日常的な運用に便利なコマンド：
```

Bash

```bash
docker logs -f mawari-node
```

正常に稼働しているノードのログには、定期的なハートビートの記録が表示されます。

#### 💡 重要な注意事項

* ノードのバーナーウォレットは、L3ネットワーク上でのガス代を支払うために $MAWARI トークンを必要とします。残高がなくなるとハートビートが停止するため、定期的に補充（トップアップ）してください。
* ノードは、DELEGATOR\_ALLOWLIST に登録されているアドレスからの割り当てオファーのみを自動的に受け入れます。ステップ3で、これがご自身のホルダーウォレットに正しく設定されていることを確認してください。

#### 🔧 トラブルシューティング

* ノードが docker ps に表示されない
  * docker logs mawari-node を実行してエラーを確認し、docker start mawari-node で再起動してください。
* ノードアドレスが見つからない
  * ステップ3のログ確認コマンドを再実行してください： docker logs mawari-node 2>&1 | grep "Burner wallet"
* 割り当て（Assignment）が受け入れられない
  * 以下3点を確認してください。
    1. 割り当てオファー（Assignment Offer）が正しいノードアドレスに対して作成されているか。
    2. DELEGATOR\_ALLOWLIST にご自身のホルダーウォレットが設定されているか。
    3. ノードのバーナーウォレットにガス代用の $MAWARI が入っているか。

設定不要のお任せ運用をご希望ですか？その場合は[ エコシステムパートナーへのライセンス委任](https://www.google.com/search?q=/mawari-economy/run-your-nodes/assigning-your-licenses-to-an-ecosystem-partner.md) をご覧ください。

<br>


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.mawari.net/mawari-network-docs-japanese/mawari-economy/ndono-run-your-nodes/nogdianndowosuruserufuhosuto-run-your-own-guardian-node.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.