// on the map
You don't need to sign up anywhere to get your node on the map. With a few lines in your config your node sends out discovery announces and shows up on the map at rmap.world.
When you add discoverable = yes to an interface in your Reticulum config, your node periodically sends out a signed discovery announce. That announce contains your interface parameters, location and name. The map at rmap.world listens for these announces and automatically places a pin.
Only interfaces where you explicitly set discoverable = yes appear on the map.
| What is sent automatically | What you fill in yourself |
|---|---|
| Interface type, radio parameters (frequency, BW, SF, CR), transport status, online status | Location (latitude/longitude), name, announce interval |
Add these lines to your interface in ~/.reticulum/config. You can look up the location via Google Maps: right-click on your location and copy the coordinates.
# Example: TCPServerInterface on the map
[[My Node]]
type = TCPServerInterface
enabled = yes
listen_ip = 0.0.0.0
listen_port = 4242
# Discovery settings
discoverable = yes
discovery_name = My Node Amsterdam
latitude = 52.3791
longitude = 4.9003
height = 15
announce_interval = 360
# Example: RNodeInterface (LoRa) on the map
[[My LoRa Node]]
type = RNodeInterface
enabled = yes
port = /dev/ttyUSB0
frequency = 869463000
bandwidth = 125000
spreadingfactor = 8
codingrate = 5
# Discovery settings
discoverable = yes
discovery_name = My LoRa Node
latitude = 52.3791
longitude = 4.9003
height = 15
announce_interval = 360
| Parameter | What it does | Example |
|---|---|---|
| discoverable | Turns discovery on or off | yes |
| discovery_name | Name that appears on the map | ReticulumNet Amsterdam |
| latitude | Latitude | 52.3791 |
| longitude | Longitude | 4.9003 |
| height | Height in meters above sea level | 15 |
| announce_interval | How often the announce is sent (minutes) | 360 (default 6 hours) |
| reachable_on | Public address of your node (optional) | my.server.nl |
A LoRa RNode cannot reach the internet directly. Your discovery announce only reaches the map if a transport node with a TCP interface forwards it to the internet.
Connect your transport node directly to rmap.world:
# Add to your config for a direct connection to rmap.world
[[RMAP World]]
type = TCPClientInterface
enabled = yes
target_host = rmap.world
target_port = 4242
Or connect to node.reticulumnet.nl:4242. Our node is connected to rmap.world, so your announces are forwarded automatically.
| Question | Answer |
|---|---|
| My node doesn't appear on the map | Check: discoverable = yes is in the config, the interface is enabled, your node is reachable over the network, and at least one announce has been sent (wait a few minutes after starting up). |
| My node is on the map but without a location | Add latitude, longitude and height to your interface config. Without those fields your node appears in the sidebar but not as a pin on the map. |
| How long does my node stay on the map? | Nodes disappear after 7 days without a new announce. As long as your node runs with discoverable = yes, it stays visible. |
| Which RNS version do I need? | RNS 1.1.0 or higher. The discovery system also needs LXMF (pip install lxmf). |
| How do I find my coordinates? | Google Maps: right-click on your location, the coordinates are at the top. The first number is latitude, the second is longitude. |