2022-05-20 12:48:34 +00:00
|
|
|
# Quickstart: running a nwaku node
|
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
This guide helps you run a nwaku node with typical configuration.
|
|
|
|
It connects your node to the `wakuv2.prod` fleet for bootstrapping
|
|
|
|
and enables discovery v5 for continuous peer discovery.
|
|
|
|
Only [`relay`](https://rfc.vac.dev/spec/11/) protocol is enabled.
|
|
|
|
For a more comprehensive overview,
|
|
|
|
see our [step-by-step guide](./overview.md).
|
2022-05-20 12:48:34 +00:00
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
## Option 1: run nwaku binary
|
2022-09-13 10:41:36 +00:00
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
*Prerequisites are the usual developer tools,
|
|
|
|
such as a C compiler, Make, Bash and Git.*
|
2022-05-20 12:48:34 +00:00
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
```bash
|
|
|
|
git clone --recurse-submodules https://github.com/status-im/nwaku
|
|
|
|
cd nwaku
|
|
|
|
make wakunode2
|
|
|
|
./build/wakunode2 \
|
|
|
|
--dns-discovery:true \
|
|
|
|
--dns-discovery-url:enrtree://AOGECG2SPND25EEFMAJ5WF3KSGJNSGV356DSTL2YVLLZWIV6SAYBM@prod.waku.nodes.status.im \
|
|
|
|
--discv5-discovery \
|
|
|
|
--nat=extip:[yourpublicip] # or, if you are behind a nat: --nat=any
|
|
|
|
```
|
2022-05-20 12:48:34 +00:00
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
## Option 2: run nwaku in a Docker container
|
2022-05-20 12:48:34 +00:00
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
*Prerequisite is a [Docker installation](./docker-quickstart.md#prerequisites).*
|
2022-06-28 10:22:59 +00:00
|
|
|
|
|
|
|
```bash
|
2022-10-24 08:31:33 +00:00
|
|
|
docker run -i -t -p 60000:60000 -p 9000:9000/udp \
|
|
|
|
statusteam/nim-waku:v0.12.0 \ # or, the image:tag of your choice
|
|
|
|
--dns-discovery:true \
|
|
|
|
--dns-discovery-url:enrtree://AOGECG2SPND25EEFMAJ5WF3KSGJNSGV356DSTL2YVLLZWIV6SAYBM@prod.waku.nodes.status.im \
|
|
|
|
--discv5-discovery \
|
|
|
|
--nat:extip:[yourpublicip] # or, if you are behind a nat: --nat=any
|
2022-06-28 10:22:59 +00:00
|
|
|
```
|
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
## Tips and tricks
|
2022-06-28 10:22:59 +00:00
|
|
|
|
2022-10-24 08:31:33 +00:00
|
|
|
To find the public IP of your host,
|
|
|
|
you can use
|
2022-06-28 10:22:59 +00:00
|
|
|
|
|
|
|
```bash
|
2022-10-24 08:31:33 +00:00
|
|
|
dig TXT +short o-o.myaddr.l.google.com @ns1.google.com | awk -F'"' '{ print $2}'
|
2022-06-28 10:22:59 +00:00
|
|
|
```
|