Running a node helps secure and decentralize the COTI network and support the overall ecosystem. While there are some similarities to other L2 networks, COTI’s architecture has its own nuances and requirements that we cover in this documentation.
In the COTI network, full nodes are decentralized, lean clients that play a critical role in maintaining the network’s security, scalability, and overall functionality. Anyone can run a full node to support the network and, when they meet the ecosystem’s eligibility rules, earn rewards.
Running a COTI full node downloads a copy of the COTI blockchain and verifies the validity of every block. Unlike validator nodes in Ethereum, COTI full nodes do not actively participate in consensus nor in block proposal; that is the role of the COTI sequencer (see COTI Architecture).
Running a COTI node offers several benefits:
- Network participation — Contribute to the decentralization and robustness of the network.
- Community support — Strengthen the ecosystem and help drive adoption of COTI’s technology.
- Rewards and incentives — Eligible operators can earn rewards when their node meets the thresholds and rules described in this Node Ecosystem section (for example uptime, DNS reachability, and token holdings requirements where applicable).
The COTI Node Ecosystem is the product surface that lets anyone run, monitor, and earn rewards from a COTI full node through a guided flow. It is composed of:
- a web app that guides operators from zero to a live, reward-eligible node (see Networks below for the URLs),
- an automated installer that stands up a COTI full node on Ubuntu 24.04 LTS (Linux servers) or a certified Windows 11 + WSL 2 + Ubuntu 24.04 LTS setup in a single command,
- a set of backend services that discover peers, mint node NFTs, monitor uptime, and distribute rewards each epoch.
This section documents the product — what it does, how to install a node through it, how its UI is organized, and the terminology you will encounter along the way.
The same COTI full node software powers the network whether you onboard through the web app or build the stack yourself.
If you are new to running a node, start with the web app wizard — it is the fastest path for most people: open the web app from Networks, follow the setup flow, then read Installation and the matching subpage — Wizard tunnel (--with-frp) or Own domain (Nginx) (--with-nginx) — plus the UI guide. Manual full node setup is for operators who want Git clone, Docker Compose, and scripts without the wizard.
| Path | When to use it | Documentation |
|---|---|---|
| Web app wizard (recommended first) | Guided flow and one-liner from Networks. Use tunnel (--with-frp, COTI subdomain, internal Docker Nginx gateway + FRPC; no host TLS) or own domain + host Nginx (--with-nginx). |
Installation, Wizard tunnel, Own domain, UI guide |
| Manual (without the wizard) | You administer the stack yourself — not the Nodes web UI installer. | Under Installation: Manual full node setup |
The COTI Node Ecosystem Litepaper summarizes the Node Economy; incentive rules apply to both paths when you meet eligibility.
Certified OS and hardware for both paths are documented once on Server requirements.
Operators on the manual path can still earn rewards when they satisfy the same thresholds as wizard users (FQDN, reachability, uptime, holdings, etc.) — see the Installation section, especially Manual full node setup.
The ecosystem runs on two networks. All guidance in this section applies to both unless noted; look up the right URL or value in the table below.
| Testnet | Mainnet | |
|---|---|---|
| Web app | testnet.nodes.coti.io | nodes.coti.io |
| Status page (public, hot nodes) | testnet.uptime.coti.io | uptime.coti.io |
| Installer host | fullnode.testnet.coti.io |
fullnode.mainnet.coti.io |
Installer scripts (replace <network> with testnet or mainnet from the row above):
- Linux / WSL —
https://fullnode.<network>.coti.io/install-linux(install_coti-full-node.sh) - macOS —
https://fullnode.<network>.coti.io/install-mac(install_coti-full-node-mac.sh)
The status page is the public Better Stack dashboard where every hot node's monitor is visible. It is the fastest way to eyeball the current health of the whole fleet.
- One-command install of a COTI full node on a certified OS (Ubuntu 24.04 LTS on Linux, or Windows 11 with WSL 2 and Ubuntu 24.04 LTS), with either a COTI-managed tunnel (FRPC + internal Docker
nginx-frpc-gateway; no host Nginx/TLS) or HTTPS on your server via host Nginx when you bring your own domain. - Local operator status page on the node host (
http://127.0.0.1:8090, plus/operator/over HTTPS when exposed) for sync, peers, and reachability checks. - Live visibility into the node fleet — Who is online, which nodes are hot, how many earned rewards this epoch.
- Per-operator dashboard for your own node(s): thermal state, uptime, latency, rewards history, eligibility.
- Automatic monitoring registration in Better Stack once your node is recognized by the network.
- Rewards distribution every epoch to operators who meet the eligibility rules (holdings + uptime).
flowchart LR
Operator([Node operator])
UI["COTI Nodes web app"]
FullNode["COTI full node<br/>(operator server)"]
PDS["Peer Discovery"]
NFT["NFT service"]
BSI["Better Stack integration"]
NHM["Node Health Monitor"]
NRS["Node Rewards"]
BetterStack[(Better Stack)]
Chain[(COTI network)]
Operator -->|guided setup| UI
UI -->|one-liner installer| FullNode
FullNode -->|admin_peers, eth_blockNumber| PDS
PDS -->|"hot event"| NFT
NFT -->|mint Soulbound NFT| Chain
NFT --> BSI
BSI -->|register monitor via FQDN| BetterStack
BetterStack -->|"GET /monitor"| NHM
NHM -->|"eth_blockNumber"| FullNode
NRS -->|read uptime + holdings| BetterStack
NRS -->|distribute rewards per epoch| Chain
UI -->|read stats + per-node data| PDS
UI --> NFT
UI --> BSI
UI --> NRS
{% hint style="warning" %} A valid DNS (FQDN) is required to earn rewards. The ecosystem measures your node's uptime by reaching its JSON-RPC endpoint through the domain name you configure. A node without a reachable DNS can still sync the chain, but it will not be credited with uptime and therefore will not receive rewards. See Own domain (Nginx + TLS) for DNS and port prerequisites (or Wizard tunnel for the COTI-assigned hostname path). {% endhint %}
Installation (pick your path — order matches the docs sidebar):
- Installation hub — overview, shared flags, after-wizard notes.
- Wizard tunnel (
--with-frp) — COTI subdomain, FRPC, internal Docker Nginx gateway; no host TLS. - Own domain (Nginx + TLS) (
--with-nginx) — your FQDN, Let’s Encrypt on the host. - Manual full node setup — Git clone, Docker Compose, ports, restart/stop, FAQ (no wizard; OS/hardware still Server requirements).
Also:
- Server requirements — certified OS, Docker stack, hardware and disk.
- UI guide — wizard walkthrough and warm-up.
Reference:
- COTI Node Ecosystem Litepaper — Node Economy (PDF embed).
- Features — everything the product does, end-to-end.
- Backend services — the five services behind the ecosystem, described from an operator's perspective.
- Glossary — thermal states, NFT states, warm-up windows, eligibility, and other terms you will see in the UI.