Inicie uma comunidade

Cada comunidade opera em seu próprio nó: um pequeno servidor que armazena os membros, publicações e o registro daquela comunidade. Alguém da região o administra. Se sua cidade ou bairro ainda não tem um, pode ser você.

O que envolve manter uma comunidade

Cerca de meia hora, se você puder seguir uma receita. Seis pontos para saber antes:

Quanto custa. O software é gratuito. Ele roda em um computador sobressalente ligado em casa (um Mini PC, um NAS ou um Raspberry Pi com sistema de 64 bits) ou em um pequeno servidor alugado por poucos dólares ao mês (cerca de US$ 6).
Quem hospeda. Você, na sua própria máquina ou na que alugar. Nunca depende do beanpool.org: seu próprio endereço web funciona perfeitamente.
Suas responsabilidades. Denúncias dos membros chegam a você. A pasta de dados fica sob sua responsabilidade de backup, com um código de recuperação. Mantenha dois proprietários. Mantenha o servidor ligado e atualizado.
O que você nunca vê. As mensagens diretas dos membros.
Docker primeiro. A máquina precisa ter o Docker instalado antes de executar o bloco abaixo; um servidor recém-alugado não vem com ele.
Um endereço acessível por celulares. Celulares acessam uma comunidade na internet somente por https. Em um servidor alugado com IP público e portas 80 e 443 abertas, o próprio endereço IP é suficiente: seu servidor obtém seu próprio certificado para ele, sem precisar de conta no Cloudflare, valendo o mesmo para um domínio próprio. Em casa, ou sem portas abertas, a reivindicação fornece um nome gratuito terminado em .beanpool.org, por meio de um túnel executado pelo próprio servidor. Um endereço http:// simples funciona apenas em rede local doméstica.

🧰

Do que você cuida

Você e os administradores que nomear são os moderadores da sua comunidade: as denúncias chegam até vocês. Os dados dos seus membros ficam na sua máquina, portanto você cuida dos backups. Você pode ler discussões de empreendimentos e bate-papos de eventos; não pode ler mensagens diretas. Você convida os primeiros membros, e eles convidam os demais.

⚙️

O aplicativo de configurações

Seu nó vem com seu próprio aplicativo de configurações no navegador. Nele você dá nome à sua comunidade, nomeia um proprietário e administradores que entram com suas próprias chaves, imprime convites com QR code, monitora a integridade do disco, escolhe um endereço web público ou um túnel e ajuda um membro que perdeu tanto o celular quanto suas 12 palavras a recuperar a conta em um aparelho novo, com um código de uso único confirmado pessoalmente.

🔒

Privado desde a primeira inicialização

Os anúncios, mapa, mensagens e saldos de uma comunidade são reservados aos membros desde o momento em que o nó é iniciado; não há nada para ativar. Qualquer pessoa que abrir seu endereço sem ter uma conta é direcionada para a comunidade global, onde pode ver o que está por perto e pedir para entrar.

🌐

Conexão com uma comunidade vizinha

Duas comunidades podem combinar de se conectar para que seus membros negociem entre si. Os Feijões nunca saem de casa: cada par mantém uma contagem contínua do que uma comunidade deve à outra, e cada lado define seu próprio limite. A conexão fica desativada a menos que ambos os operadores a ativem, e o recurso ainda está em fase inicial: já está construído, com suas telas no app web, e foi testado apenas entre duas de nossas comunidades de teste, nunca entre nós reais em produção.

Seu endereço

Escolha-o antes de colar e altere a última linha conforme necessário. Se já tiver colado, pressione Enter nas perguntas e execute a última linha novamente: o código de reivindicação aguarda um celular. Um servidor alugado com IP público e portas 80 e 443 abertas: adicione --ip e o endereço IP, como em beanpool claim --ip 203.0.113.7. Seu servidor obtém seu próprio certificado para esse endereço via Let's Encrypt, pela porta 80, e os celulares o acessam em https://203.0.113.7. Um computador em casa, ou sem portas abertas: deixe como está. Ele pedirá a primeira parte de um nome gratuito (digite apenas suacidade para suacidade.beanpool.org; Enter pula), acessado por um túnel que seu próprio servidor executa, e aguarda até três minutos para entrar no ar. Seu próprio domínio: aponte um registro A para o IP do servidor, abra as portas 80 e 443 e adicione --address https://seu.dominio. Um nome sobrevive à troca de servidor; um número, não: você pode adicionar um nome depois em Configurações, e os membros que usam o IP continuam conectados normalmente. Para escolher depois em Configurações, adicione --no-name. Um endereço http:// simples funciona apenas em rede doméstica: celulares o recusam na internet, e a reivindicação emite um aviso. Se o serviço de endereçamento do projeto BeanPool estiver fora do ar, a reivindicação ainda assim funciona.

Instalação

Em seguida, nessa máquina com o Docker instalado, cole este bloco único. Ele baixa o arquivo compose, cria a rede que o nó usa, baixa a imagem publicada (Intel/AMD ou ARM64), inicia o nó, aguarda até que o servidor crie seu código de reivindicação único (até cinco minutos em uma primeira inicialização lenta no Raspberry Pi) e realiza a reivindicação. Não há nada para configurar antes de iniciar.

bash — iniciar uma comunidade

Bloco único: baixar, criar rede, carregar imagem, iniciar, aguardar, reivindicar

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

A última linha: beanpool claim

O código e o QR. Ele exibe um código de reivindicação único e um código QR. Escaneie o código QR com a câmera do celular ou abra o BeanPool, digite o endereço do servidor em Encontre sua comunidade e toque em Reivindicar. Aquele aparelho se torna o proprietário.
Configurações. Abra seu endereço (ou o próprio endereço do servidor) seguido de /settings. O assistente de configuração dá nome à sua comunidade, pede para você adicionar um segundo proprietário e gera três convites de fundador. Defina seu local no mapa em Identidade do Nó para que pessoas próximas possam encontrar você.

Se o bloco indicar No claim code after 5 minutes ou beanpool claim disser This community has no claim code waiting, o servidor ainda não terminou de inicializar: docker compose logs beanpool-node mostra o status. Assim que o log indicar que a comunidade ainda não tem proprietário e tem um código de reivindicação, execute a última linha novamente. As etapas completas estão na configuração inicial do manual do operador.

Recomendado: mantenha sua comunidade funcionando quando o Docker atualizar

O passo está na página "Updates and health" do manual do operador. Um assistente de IA que faz a instalação sempre executa este passo (Configurar o seu servidor com um assistente de IA).

Ver no GitHub →