Máscara → villa → nodo → vínculo → retribución. Este es el viaje.
Mask → villa → node → link → retribution. This is the journey.
Correr un nodo: un comando. El instalador hace el resto.
Running a node: one command. The installer does the rest.
A
Linux — un comando
Linux — one command
El instalador detecta tu máquina (x86_64 o ARM64), baja el binario verificando su SHA256, coloca el chainspec, crea el servicio y lo arranca. Tú no eliges binario; si el hash no cuadra, aborta.
The installer detects your machine (x86_64 or ARM64), downloads the binary verifying its SHA256, drops the chainspec, creates the service and starts it. You don't pick a binary; if the hash doesn't match, it aborts.
Lo que hace falta, medido y sin adornos: 4 GB de memoria, 2 núcleos y 3 GB de disco libres — la cadena ocupa unos 600 MB hoy y crece. Con memoria holgada, la cadena entera se sincroniza en un par de minutos y el nodo se queda luego en unos 230 MB.
Con menos de 4 GB puedes, pero vas con el freno puesto. Todo esto está medido, no supuesto: con 1 GB no termina — se queda a medio camino sin dar ningún error. Con 2 GB sí termina, sincroniza entero, comprueba el anclaje y se pone a verificar como debe… rozando el techo: el sistema le quita memoria a la caché una y otra vez para que quepa (2.657 veces durante una sola sincronización). Y sí, sin intercambio tampoco lo mata —lo dijimos antes y era falso, lo medimos después—: en vez de matarlo, le recorta la caché, porque esa memoria se puede recuperar.
El porqué, que no es evidente: el nodo en sí es pequeño. Lo que llena la memoria es la caché de su base de datos, que usa el aire que encuentre y lo devuelve cuando hace falta. Por debajo de 4 GB esa caché no tiene dónde encogerse y acaba peleándose con el propio nodo. No es hambre: es estrangulamiento.
What you need, measured and unvarnished: 4 GB of memory, 2 cores and 3 GB of free disk — the chain is around 600 MB today and grows. With room to breathe the whole chain syncs in a couple of minutes and the node then settles at around 230 MB.
Below 4 GB you can, but you run with the brake on. All of this is measured, not assumed: with 1 GB it never finishes — it stalls part-way without any error. With 2 GB it does finish: it syncs the whole chain, verifies the anchor and starts verifying as it should… while scraping the ceiling, with the system clawing memory back from the cache over and over to make room (2,657 times during a single sync). And no, running without swap does not kill it either — we said it did, and we were wrong; we measured it afterwards: instead of killing it, the kernel trims the cache, because that memory can be reclaimed.
Why, which is not obvious: the node itself is small. What fills the memory is its database cache, which takes whatever room it finds and gives it back when something else needs it. Below 4 GB that cache has nowhere to shrink to and ends up fighting the node it serves. It is not hunger: it is strangling.
Antes: un servidor recién instalado suele venir pelado — sin curl y sin sudo. Si el comando de abajo responde command not found, no has hecho nada mal: te falta la herramienta. Como root (Debian/Ubuntu): apt update && apt install -y curl.
First: a freshly installed server usually comes bare — no curl, no sudo. If the command below answers command not found, you did nothing wrong: the tool is missing. As root (Debian/Ubuntu): apt update && apt install -y curl.
Si ya eres root (lo normal en un servidor nuevo), sin sudo:
If you are already root (the norm on a new server), without sudo:
curl -fsSL https://harlequinproject.org/install-harlequin-node.sh | bash
Si entras con tu usuario y tienes sudo:
If you log in as your user and have sudo:
curl -fsSL https://harlequinproject.org/install-harlequin-node.sh | sudo bash
¿Tienes wget en vez de curl? Sirve igual:
Got wget instead of curl? It works just as well:
wget -qO- https://harlequinproject.org/install-harlequin-node.sh | bash
B
Android — tablet o móvil
Android — tablet or phone
Lo prometido: la red cabe en tu bolsillo. Instala Termux (de F-Droid), y dentro:
As promised: the network fits in your pocket. Install Termux (from F-Droid), then inside it:
pkg install -y proot-distro && proot-distro install debian && proot-distro login debian
Y ya dentro de Debian, el mismo instalador de arriba (sin sudo): detecta el ARM y arranca tu nodo en primer plano. Ctrl+C lo para; ~/harlequin/run-node.sh lo vuelve a arrancar.
Once inside Debian, the same installer as above (no sudo): it detects ARM and starts your node in the foreground. Ctrl+C stops it; ~/harlequin/run-node.sh starts it again.
curl -fsSL https://harlequinproject.org/install-harlequin-node.sh | bash
D
Tu llave, sin amo
Your key, no master
Al arrancar, el nodo crea su llave de red —su identidad entre nodos— en un fichero solo tuyo. No guarda fondos ni voz: solo dice «este nodo es este». Tu máscara —con la que entras a la sociedad, y donde llegará la retribución por servicio cuando se active— es aparte, la guardas tú, y nadie, ni nosotros, puede tocarla.
Correr un nodo no te hace miembro ni te da reputación: miembro eres con tu máscara («Únete»), y la voz se gana con tu conducta —tratos, trabajo, la confianza que otros te prestan—, nunca por enchufar una máquina. Todos empezáis igual: nadie te da permiso para existir en la red.
Nodo sin máscara: sostienes la red. Nodo vinculado a tu máscara: además, tu servicio consta como tuyo. El vínculo (estación 5) existe ya en la cadena y es gratis para una máscara nueva, pero todavía no hay botón: hoy se hace a mano. Y conviene decir lo que casi nadie dice: cobrar no depende solo del vínculo. Lo que se retribuye es el servicio en el comité —autoría y voto—, y al comité se entra por reputación ganada, no por encender una máquina. Un nodo seguidor sostiene la red, y eso ya es real; no genera todavía servicio retribuible.
When it starts, the node creates its network key —its identity among nodes— in a file only you hold. It keeps no funds and no voice: it just says “this node is this one”. Your mask —the one you enter the society with, and where service retribution will arrive once it is switched on— is separate, you alone keep it, and no one, not even us, can touch it.
Running a node doesn't make you a member or grant you reputation: you are a member through your mask («Join»), and a voice is earned through your conduct —deals, work, the trust others lend you—, never by plugging in a machine. Everyone starts equal: no one grants you permission to exist on the network.
Node without a mask: you hold the network up. Node linked to your mask: your service is recorded as yours. The link (station 5) already exists on-chain and is free for a new mask, but there is no button yet: today it is done by hand. And here is the part few projects say out loud: getting paid does not depend on the link alone. What is paid for is service in the committee — authorship and votes — and the committee is entered through earned reputation, not by switching on a machine. A follower node holds the network up, which is already real; it does not yet generate payable service.
✓
¿Va bien?
Is it working?
En los registros verás 🎭 finalised #N con el número subiendo: tu nodo está sincronizado y sosteniendo la red. La reputación —la que da voz— se gana aparte, con tu conducta, no por enchufar máquinas.
In the logs you'll see 🎭 finalised #N with the number rising: your node is synced and holding the network up. Reputation —the thing that gives a voice— is earned separately, through your conduct, not by plugging in machines.
Linux x86_64/ARM64, Android o DockerLinux x86_64/ARM64, Android or Docker
~2 GB RAM
~20 GB disco~20 GB disk
puerto 30333/tcpport 30333/tcp