Monta tu propio relay

Para AegisLink 1.0.7+ · Privacidad → Red → Mi relay

Un relay de AegisLink es un buzón ciego: recibe sobres sellados (nunca ve quién escribe a quién) y los guarda hasta que el destinatario los recoge. Montar el tuyo significa que tus mensajes nunca pasan por el relay oficial. Tu identidad y tu buzón viven en tu máquina, y tus contactos —estén en el relay oficial o en cualquier otro— te escriben directamente a él por Tor. No hay red entre relays ni directorio global.

Solo .onion. El relay se publica como servicio oculto de Tor v3. Sin listener clearnet, sin certificado TLS, sin dominio, sin abrir puertos en tu router. Tu máquina nunca aprende la IP de nadie y nadie necesita saber dónde está.
No es un relay ni un exit de Tor. El contenedor de Tor solo publica tu servicio.
El mismo código que el relay oficial, abierto y auditable.

1. Qué necesitas

Un equipo encendido cuando quieras recibir mensajes: un VPS de 2 GB, un mini-PC en casa o una Raspberry Pi 4. Sin IP pública, sin dominio.
Docker con el plugin compose (Docker 24+).
Salida a Internet (Tor necesita conectarse a la red Tor; no entra nada).
Opcional: qrencode (sudo apt install qrencode) para que la dirección salga también como código QR.

2. Levántalo

git clone https://codeberg.org/aegislink2026/AegisLink.git
cd AegisLink/infra/selfhost
./up.sh

up.sh es idempotente: crea .env, genera los secretos obligatorios, construye y arranca el relay, Tor y el notificador de avisos, espera a que Tor publique el servicio e imprime tu dirección (y su código QR, si tienes qrencode):

  Your relay:  http://xxxxxxxx…xxxxxxxx.onion

La primera publicación puede tardar 1–3 minutos. Vuelve a verla cuando quieras con ./print-onion.sh. Para actualizar tras un git pull, ejecuta ./up.sh otra vez — los datos y la clave del onion se conservan.

3. Apunta la app a tu relay

En AegisLink, abre Privacidad → Red → Mi relay. Pulsa Escanear QR del relay y apunta la cámara al QR de la terminal (en escritorio: Importar imagen de QR desde una captura), o pega la dirección .onion. Luego pulsa Verificar relay: la app comprueba por Tor que es un relay de AegisLink con buzones y prekeys.
Pulsa Cambiar a …onion, lee las consecuencias y confirma (con tu PIN o biometría si tienes el bloqueo de la app activado).
La app se registra en tu relay, avisa a todos tus contactos de tu nueva dirección dentro del canal cifrado y cambia. Durante 7 días sigue recibiendo también en el relay anterior; quien no abra la app en ese tiempo necesitará tu enlace nuevo.

¿Lo montas para tu familia o amigos? Envíales una foto del QR por un canal de confianza: lo escanean desde la misma pantalla. Siempre puedes volver con Volver al relay oficial — la misma migración al revés.

4. Guarda la clave del onion

La dirección .onion es una clave, y vive solo en tu máquina. Si la pierdes, tu dirección cambia y todos los que usan tu relay tienen que volver a cambiar. Guarda una copia fuera de la máquina:

./backup-onion-key.sh          # → tor_keys-<fecha>.tar.gz (modo 600)

Quien tenga ese archivo puede suplantar tu relay: trátalo como una clave privada.

Llamadas

La señalización va sellada por tu relay, pero el audio y el vídeo viajan de móvil a móvil, no por Tor. Sin un servidor TURN, dos usuarios detrás de NATs restrictivos pueden no conectar (el chat no se ve afectado). Para llamadas fiables, monta coturn en una máquina con IP pública y pon TURN_HOST en el .env del relay.

Qué ve el operador

Exactamente lo que ve el relay oficial de sus usuarios, ni más: ids de buzón opacos que rotan a diario, sobres cifrados y cuándo se recogen. Nunca IPs (Tor), nunca quién escribe a quién (sealed sender), nunca contenido.

Guía completa

Todas las opciones, la solución de problemas y el diseño están en el repositorio: docs/SELF-HOSTING.md y el paquete de self-hosting en infra/selfhost.

Run your own relay

For AegisLink 1.0.7+ · Privacy → Network → My relay

An AegisLink relay is a blind mailbox: it receives sealed envelopes (it never sees who writes to whom) and holds them until the recipient collects them. Running your own means your messages never pass through the official relay. Your identity and your mailbox live on your machine, and your contacts — on the official relay or any other — write to it directly over Tor. There is no network between relays and no global directory.

Onion only. The relay is published as a Tor v3 hidden service. No clearnet listener, no TLS certificate, no domain, no port opened on your router. Your machine never learns anyone's IP, and nobody needs to know where it runs.
Not a Tor relay or exit. The Tor sidecar only publishes your service.
Same code as the official relay, open source and auditable.

1. What you need

A machine that is on when you want to receive messages: a 2 GB VPS, a home mini-PC or a Raspberry Pi 4. No public IP, no domain.
Docker with the compose plugin (Docker 24+).
Outbound Internet access (Tor needs to reach the Tor network; nothing comes in).
Optional: qrencode (sudo apt install qrencode) so the address is also printed as a QR code.

2. Start it

git clone https://codeberg.org/aegislink2026/AegisLink.git
cd AegisLink/infra/selfhost
./up.sh

up.sh is idempotent: it creates .env, generates the required secrets, builds and starts the relay, Tor and the wake-up notifier, waits for Tor to publish the service and prints your address (and its QR code, if qrencode is installed):

  Your relay:  http://xxxxxxxx…xxxxxxxx.onion

The first publication can take 1–3 minutes. Print it again any time with ./print-onion.sh. To update after a git pull, run ./up.sh again — data and onion key are kept.

3. Point the app at it

In AegisLink, open Privacy → Network → My relay. Tap Scan relay QR and point the camera at the QR in the terminal (on desktop: Import QR image from a screenshot), or paste the .onion address. Then tap Verify relay: the app checks over Tor that it is an AegisLink relay with mailboxes and prekeys.
Tap Switch to …onion, read the consequences and confirm (with your PIN or biometrics if the app lock is on).
The app registers on your relay, tells all your contacts your new address inside the encrypted channel, and switches. For 7 days it keeps receiving on the previous relay too; anyone who doesn't open the app in that time will need your new link.

Running it for family or friends? Send them a photo of the QR over a channel you trust — they scan it from the same screen. You can always go back with Back to the official relay — the same migration in reverse.

4. Back up the onion key

The .onion address is a key, and it lives only on your machine. If you lose it, your address changes and everyone using your relay has to switch again. Keep a copy off the machine:

./backup-onion-key.sh          # → tor_keys-<date>.tar.gz (mode 600)

Anyone holding that file can impersonate your relay: treat it like a private key.

Calls

Signalling goes sealed through your relay, but audio and video travel phone to phone, not over Tor. Without a TURN server, two users behind strict NATs may fail to connect (chat is unaffected). For reliable calls, run coturn on a machine with a public IP and set TURN_HOST in the relay's .env.

What the operator can see

Exactly what the official relay sees of its users, no more: opaque mailbox ids that rotate daily, encrypted envelopes, and when they are collected. Never IPs (Tor), never who writes to whom (sealed sender), never content.

Full guide

Every option, troubleshooting and the design behind it are in the repository: docs/SELF-HOSTING.md (Spanish) and the self-host package in infra/selfhost.

Avvia il tuo relay

Per AegisLink 1.0.7+ · Privacy → Rete → Il mio relay

Un relay di AegisLink è una casella cieca: riceve buste sigillate (non vede mai chi scrive a chi) e le conserva finché il destinatario non le ritira. Avviare il tuo significa che i tuoi messaggi non passano mai dal relay ufficiale. La tua identità e la tua casella vivono sulla tua macchina, e i tuoi contatti — sul relay ufficiale o su qualsiasi altro — ti scrivono direttamente lì tramite Tor. Non c'è una rete tra relay né una directory globale.

Solo .onion. Il relay è pubblicato come servizio nascosto Tor v3. Nessun listener clearnet, nessun certificato TLS, nessun dominio, nessuna porta aperta sul router. La tua macchina non conosce mai l'IP di nessuno e nessuno deve sapere dove si trova.
Non è un relay né un exit Tor. Il container Tor pubblica solo il tuo servizio.
Lo stesso codice del relay ufficiale, open source e verificabile.

1. Cosa ti serve

Una macchina accesa quando vuoi ricevere messaggi: un VPS da 2 GB, un mini-PC in casa o un Raspberry Pi 4. Niente IP pubblico, niente dominio.
Docker con il plugin compose (Docker 24+).
Accesso a Internet in uscita (Tor deve raggiungere la rete Tor; non entra nulla).
Facoltativo: qrencode (sudo apt install qrencode) per stampare l'indirizzo anche come codice QR.

2. Avvialo

git clone https://codeberg.org/aegislink2026/AegisLink.git
cd AegisLink/infra/selfhost
./up.sh

up.sh è idempotente: crea .env, genera i segreti obbligatori, costruisce e avvia il relay, Tor e il notificatore, attende che Tor pubblichi il servizio e stampa il tuo indirizzo (e il suo codice QR, se hai qrencode):

  Your relay:  http://xxxxxxxx…xxxxxxxx.onion

La prima pubblicazione può richiedere 1–3 minuti. Rivedilo quando vuoi con ./print-onion.sh. Per aggiornare dopo un git pull, esegui di nuovo ./up.sh — dati e chiave onion vengono conservati.

3. Collega l'app

In AegisLink, apri Privacy → Rete → Il mio relay. Tocca Scansiona QR del relay e inquadra il QR nel terminale (su desktop: Importa immagine QR da uno screenshot), oppure incolla l'indirizzo .onion. Poi tocca Verifica relay: l'app controlla tramite Tor che sia un relay AegisLink con caselle e prekey.
Tocca Passa a …onion, leggi le conseguenze e conferma (con PIN o biometria se il blocco dell'app è attivo).
L'app si registra sul tuo relay, comunica il nuovo indirizzo a tutti i contatti dentro il canale cifrato e cambia. Per 7 giorni continua a ricevere anche sul relay precedente; chi non apre l'app in quel periodo avrà bisogno del tuo nuovo link.

Lo gestisci per famiglia o amici? Invia loro una foto del QR su un canale fidato: lo scansionano dalla stessa schermata. Puoi sempre tornare indietro con Torna al relay ufficiale — la stessa migrazione al contrario.

4. Fai il backup della chiave onion

L'indirizzo .onion è una chiave e vive solo sulla tua macchina. Se la perdi, il tuo indirizzo cambia e chi usa il tuo relay deve cambiare di nuovo. Conservane una copia fuori dalla macchina:

./backup-onion-key.sh          # → tor_keys-<data>.tar.gz (modo 600)

Chi possiede quel file può impersonare il tuo relay: trattalo come una chiave privata.

Chiamate

La segnalazione passa sigillata dal tuo relay, ma audio e video viaggiano da telefono a telefono, non su Tor. Senza un server TURN, due utenti dietro NAT restrittivi potrebbero non connettersi (la chat non ne risente). Per chiamate affidabili, avvia coturn su una macchina con IP pubblico e imposta TURN_HOST nel .env del relay.

Cosa vede l'operatore

Esattamente ciò che il relay ufficiale vede dei suoi utenti, niente di più: id di casella opachi che ruotano ogni giorno, buste cifrate e quando vengono ritirate. Mai IP (Tor), mai chi scrive a chi (sealed sender), mai contenuti.

Guida completa

Tutte le opzioni, la risoluzione dei problemi e il design sono nel repository: docs/SELF-HOSTING.md (in spagnolo) e il pacchetto self-host in infra/selfhost.