Avvia una comunità

Ogni comunità funziona sul proprio nodo: un piccolo server che conserva i membri, i post e il mastro di quella comunità. Lo gestisce qualcuno del posto. Se la tua città o vallata non ne ha ancora uno, potresti essere tu.

Cosa comporta gestire una comunità

Circa mezz'ora, se sai seguire una ricetta. Sei cose da sapere prima di iniziare:

Quanto costa. Il software è gratuito. Funziona su un computer inutilizzato che resta acceso a casa (un Mini PC, un NAS o un Raspberry Pi con sistema a 64 bit), oppure su un piccolo server a noleggio per pochi dollari al mese (circa 6 $ USD).
Chi lo ospita. Lo fai tu, sulla tua macchina o su quella che noleggi. Non ha mai bisogno di beanpool.org: puoi usare il tuo indirizzo web.
Cosa ti assumi. Le segnalazioni dei tuoi membri arrivano a te. La cartella dei dati spetta a te salvarla con un backup, tramite un codice di ripristino. Mantieni due proprietari. Mantieni il server acceso e aggiornato.
Cosa non vedi mai. I messaggi diretti dei tuoi membri.
Prima Docker. La macchina richiede che Docker sia installato prima di eseguire il blocco sottostante; un server appena noleggiato non lo ha.
Un indirizzo raggiungibile dagli smartphone. Gli smartphone raggiungono una comunità su Internet solo tramite https. Su un server a noleggio con un indirizzo IP pubblico e le porte 80 e 443 aperte, quell'indirizzo IP è sufficiente: il tuo server ottiene il proprio certificato per esso, senza bisogno di un account Cloudflare, e lo stesso vale per un tuo dominio personale. A casa, o senza porte aperte, la procedura di rivendicazione ti fornisce un nome gratuito che termina in .beanpool.org, attraverso un tunnel che il tuo server esegue da solo. Un semplice indirizzo http:// funziona solo su una rete domestica.

🧰

Di cosa ti occupi

Tu e gli amministratori che nomini siete i moderatori della vostra comunità: le segnalazioni arrivano a voi. I dati dei tuoi membri risiedono sulla tua macchina, quindi ne curi i backup. Puoi leggere le discussioni delle imprese e le chat degli eventi; non puoi leggere i messaggi diretti. Inviti i primi membri, e loro inviteranno gli altri.

⚙️

L'app delle impostazioni

Il tuo nodo include la propria app delle impostazioni nel browser. Da lì dai un nome alla tua comunità, nomini un proprietario e amministratori che accedono con le proprie chiavi, stampi inviti QR, controlli lo stato del disco, scegli un indirizzo web pubblico o un tunnel, e aiuti un membro che ha perso sia il telefono che le sue 12 parole a rientrare nel proprio account su un nuovo telefono, con un codice monouso che confermi di persona.

🔒

Privata fin dal primo avvio

Gli annunci, la mappa, i messaggi e i saldi di una comunità sono riservati ai suoi membri dal momento in cui il suo nodo si avvia; non c'è nulla da attivare. Chi apre il suo indirizzo senza un account viene indirizzato alla comunità globale, dove può vedere cosa c'è nelle vicinanze e chiedere di unirsi.

🌐

Collegamento con una comunità vicina

Due comunità possono concordare un collegamento affinché i rispettivi membri possano scambiare tra loro. I fagioli non lasciano mai la propria comunità: ogni coppia mantiene un conteggio continuo di quanto una comunità deve all'altra, e ciascuna parte imposta il proprio limite. Il collegamento è disattivato a meno che entrambi i gestori non lo attivino, ed è ancora in fase iniziale: è implementato, con le sue schermate nell'app web, ed è stato testato solo tra due delle nostre comunità di test, mai tra comunità reali attive.

Il tuo indirizzo

Sceglilo prima di incollare, e modifica l'ultima riga di conseguenza. Se hai già incollato, premi Invio alle relative domande, quindi esegui di nuovo l'ultima riga: il codice di rivendicazione attende un telefono. Un server a noleggio con indirizzo IP pubblico e porte 80 e 443 aperte: aggiungi --ip e il suo indirizzo IP, come in beanpool claim --ip 203.0.113.7. Il tuo server riceve il proprio certificato per quell'indirizzo da Let's Encrypt, tramite la porta 80, e i telefoni lo raggiungono su https://203.0.113.7. Un computer a casa, o nessuna porta aperta: lascialo così com'è. Chiede la prima parte di un nome gratuito (digita solo latuacitta per latuacitta.beanpool.org; Invio per saltare), raggiungibile tramite un tunnel che il tuo server esegue da solo, e attende fino a tre minuti che sia attivo. Il tuo dominio: punta un record A verso l'indirizzo IP del server, apri le porte 80 e 443, e aggiungi --address https://tuo.dominio. Un nome sopravvive a un cambio di server; un numero no: puoi aggiungere un nome in un secondo momento in Impostazioni, e i membri che usano l'indirizzo IP continueranno a funzionare normalmente. Per scegliere più tardi in Impostazioni, aggiungi --no-name. Un semplice indirizzo http:// funziona solo su una rete domestica: i telefoni lo rifiutano su Internet e la procedura di rivendicazione ti avvisa. Se il servizio degli indirizzi del progetto BeanPool non è disponibile, la procedura di rivendicazione funziona comunque.

Installazione

Quindi, su quella macchina con Docker installato, incolla questo singolo blocco. Scarica il file compose, crea la rete usata dal nodo, recupera l'immagine pubblicata (Intel/AMD o ARM64), la avvia, attende che il server generi il suo codice di rivendicazione monouso (fino a cinque minuti, per un primo avvio lento su un Raspberry Pi) e ne effettua la rivendicazione. Non c'è nulla da configurare prima dell'avvio.

bash — avvia una comunità

Un solo blocco: scarica, rete, pull, avvio, attesa, riscatto

git clone https://github.com/beanpool-org/beanpool.git && cd beanpool
docker network create beanpool-shared
docker compose pull
docker compose up -d
echo "Waiting for the server to make its claim code (up to 5 minutes)..."
for i in $(seq 60); do docker compose exec -T beanpool-node test -f /data/claim-code.txt </dev/null 2>/dev/null && break; sleep 5; done
docker compose exec -T beanpool-node test -f /data/claim-code.txt </dev/null 2>/dev/null || echo "No claim code after 5 minutes. The server's log says why: docker compose logs beanpool-node"
docker compose exec beanpool-node beanpool claim

L'ultima riga: beanpool claim

Il codice e il QR. Mostra un codice di rivendicazione monouso e un codice QR. Scansiona il codice QR con la fotocamera del telefono, oppure apri BeanPool, digita l'indirizzo del server sotto Trova la tua comunità e tocca Rivendica. Quel telefono diventa il proprietario.
Impostazioni. Apri il tuo indirizzo (o l'indirizzo del server stesso) seguito da /settings. La configurazione guidata assegna un nome alla tua comunità, ti chiede di aggiungere un secondo proprietario e crea tre inviti per i fondatori. Imposta la tua posizione sulla mappa sotto Identità nodo, così le persone nelle vicinanze potranno trovarti.

Se il blocco indica No claim code after 5 minutes, oppure beanpool claim dice This community has no claim code waiting, il server non ha ancora completato l'avvio: docker compose logs beanpool-node mostra a che punto si trova. Quando il registro indica che la comunità non ha ancora un proprietario e ha un codice di rivendicazione, esegui di nuovo l'ultima riga. I passaggi completi si trovano nella prima configurazione del manuale per i gestori.

Consigliato: tieni attiva la tua comunità quando Docker si aggiorna

Il passaggio è nella pagina «Updates and health» del manuale per i gestori. Un assistente IA che fa l'installazione esegue sempre questo passaggio (Configurare il tuo server con un assistente IA).

Visualizza su GitHub →