The project's nodes¶
The Unseenet project runs a few nodes of its own, listed in
src/unseenet/nodes.json with the project key as operator. They are the
first nodes new users are offered, so they must be connected to each other
and to every other listed node (UN-RFC 0021).
| Node | Where | Status |
|---|---|---|
unseenet-node1 |
the maintainer's Proxmox, Denmark | test node, may be reset |
unseenet-node2 |
the maintainer's Proxmox, Denmark | test node, may be reset |
| Oracle Cloud nodes | Oracle Cloud Always Free | planned |
Every project node peers with every other¶
The project's nodes form a full mesh: each has a [[peer]] for each of the
others, with groups, pull and accept all "*". Nobody has to
remember who is missing:
cd /home/unseenet/unseenet
.venv/bin/python tools/project/project_peers.py unseenet-node1 --check /home/unseenet/node.toml
prints the sections the node is missing (and exits 1), or that it has
them all. Without --check it prints every section the node needs.
When a project node is added (the Oracle Cloud nodes, say):
- Install it as any node (Installation) and note its onion address and node key.
- Add it to
src/unseenet/nodes.jsonwith the project key asoperator(by pull request, or the Add my node form). Until a project node is on the list, the tool does not know it. - On every project node, the new one included, update the checkout,
run the tool with
--check, add what it prints tonode.toml, and restart:sudo systemctl restart unseenet-node. - Check the journal on the new node for
pulled ... fromlines, and that the next day's health check reports nothing.
Peering with others¶
Anyone who asks to have a node listed can peer with the project's nodes -
the listing rules require a listed peer, and this way nobody is stuck.
When a request asks for it (the Peers field), add a [[peer]] for that
node on at least one project node, with the address and key from the
request, and tell the operator which node so they can add it back.