Iniciar una comunidad

Cada comunidad funciona en su propio nodo: un pequeño servidor que aloja a los miembros, las publicaciones y el registro de esa comunidad. Alguien local lo gestiona. Si tu pueblo o valle aún no tiene uno, podrías ser tú.

Qué implica mantener una comunidad

Alrededor de media hora, si puedes seguir una receta. Seis cosas que debes saber primero:

Cuánto cuesta. El software es gratuito. Funciona en una computadora libre que permanece encendida en casa (una Mini PC, un NAS o una Raspberry Pi con sistema de 64 bits), o en un pequeño servidor alquilado por unos pocos dólares al mes (unos US$6).
Quién lo aloja. Tú, en tu propia máquina o en la que alquiles. Nunca necesita beanpool.org: tu propia dirección web funciona.
De qué te haces cargo. Los reportes de tus miembros llegan a ti. La carpeta de datos es tuya para hacer copias de seguridad, con un código de recuperación. Mantén dos propietarios. Mantén el servidor encendido y actualizado.
Lo que nunca ves. Los mensajes directos de tus miembros.
Docker primero. La máquina necesita tener Docker instalado antes del bloque a continuación; un servidor recién alquilado no lo tiene.
Una dirección accesible para teléfonos. Los teléfonos acceden a una comunidad en internet únicamente a través de https. En un servidor alquilado con dirección IP pública y los puertos 80 y 443 abiertos, esa dirección IP es suficiente: tu servidor obtiene su propio certificado para ella, sin cuenta de Cloudflare, y lo mismo para un dominio propio. En casa, o sin puertos abiertos, el reclamo te da un nombre gratuito que termina en .beanpool.org, a través de un túnel que ejecuta tu propio servidor. Una dirección http:// simple solo funciona en una red doméstica.

🧰

De qué te encargas

Tú y los administradores que nombres son los moderadores de tu comunidad: los reportes llegan a ti. Los datos de tus miembros residen en tu máquina, por lo que tú mantienes las copias de seguridad. Puedes leer las discusiones de emprendimientos y los chats de eventos; no puedes leer los mensajes directos. Invitas a los primeros miembros y ellos invitan al resto.

⚙️

La app de ajustes

Tu nodo incluye su propia app de ajustes en el navegador. Desde allí nombras a tu comunidad, designas un propietario y administradores que inician sesión con sus propias claves, imprimes invitaciones QR, supervisas la salud del disco, eliges una dirección web pública o un túnel, y ayudas a un miembro que haya perdido tanto su teléfono como sus 12 palabras a volver a su propia cuenta en un teléfono nuevo, con un código de un solo uso que confirmas en persona.

🔒

Privada desde el primer inicio

Las publicaciones, el mapa, los mensajes y los saldos de una comunidad son para sus miembros desde el momento en que se inicia su nodo; no hay nada que activar. A quien abra su dirección sin una cuenta se le orienta hacia la comunidad global, donde puede ver lo que hay cerca y pedir unirse.

🌐

Conexión con una comunidad vecina

Dos comunidades pueden acordar conectarse para que sus miembros puedan intercambiar entre sí. Los Frijoles nunca salen de su lugar de origen: cada par lleva un recuento continuo de lo que una comunidad le debe a la otra, y cada lado establece su propio límite. La conexión está desactivada a menos que ambos operadores la activen, y todavía está en fase inicial: está desarrollada, con sus pantallas en la app web, y solo se ha probado entre dos de nuestras propias comunidades de prueba, nunca entre comunidades en vivo.

Tu dirección

Elígela antes de pegar y modifica la última línea para que coincida. Si ya pegaste, presiona Enter en sus preguntas y luego vuelve a ejecutar la última línea: el código de reclamo espera a un teléfono. Un servidor alquilado con una dirección IP pública y los puertos 80 y 443 abiertos: agrega --ip y su dirección IP, como en beanpool claim --ip 203.0.113.7. Tu servidor obtiene su propio certificado para esa dirección de Let's Encrypt a través del puerto 80, y los teléfonos se conectan a él en https://203.0.113.7. Una computadora en casa, o sin puertos abiertos: déjala como está. Pide la primera parte de un nombre gratuito (escribe solo tupueblo para tupueblo.beanpool.org; Enter omite), al que se accede a través de un túnel que ejecuta tu propio servidor, y espera hasta tres minutos para que esté activo. Tu propio dominio: apunta un registro A hacia la dirección IP del servidor, abre los puertos 80 y 443 y agrega --address https://tu.domain. Un nombre sobrevive a un cambio de servidor; un número no: puedes agregar un nombre más adelante en Ajustes, y los miembros que usen la dirección IP seguirán funcionando. Para elegir más adelante en Ajustes, agrega --no-name. Una dirección http:// simple solo funciona en una red doméstica: los teléfonos la rechazan en internet y el reclamo te advertirá. Si el servicio de direcciones del proyecto BeanPool está caído, el reclamo aún funciona.

Instalación

Luego, en esa máquina con Docker instalado, pega este único bloque. Descarga el archivo compose, crea la red que usa el nodo, descarga la imagen publicada (Intel/AMD o ARM64), lo inicia, espera hasta que el servidor haya generado su código de reclamo de un solo uso (hasta cinco minutos, para un primer inicio lento en una Raspberry Pi) y lo reclama. No hay nada que configurar antes de que inicie.

bash — iniciar una comunidad

Un bloque: descargar, red, imagen, iniciar, esperar, reclamar

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

La última línea: beanpool claim

El código y el QR. Muestra un código de reclamo de un solo uso y un código QR. Escanea el código QR con la cámara de tu teléfono, o abre BeanPool, escribe la dirección del servidor en Encuentra tu comunidad y toca Reclamar. Ese teléfono se convierte en el propietario.
Ajustes. Abre tu dirección (o la dirección propia del servidor) seguida de /settings. El asistente de configuración nombra a tu comunidad, te pide que agregues un segundo propietario y crea tres invitaciones iniciales. Establece tu ubicación en el mapa en Identidad del nodo para que las personas cercanas puedan encontrarte.

Si el bloque dice No claim code after 5 minutes, o beanpool claim dice This community has no claim code waiting, el servidor no ha terminado de iniciar: docker compose logs beanpool-node muestra su estado. Una vez que el registro indique que la comunidad aún no tiene propietario y tiene un código de reclamo, vuelve a ejecutar la última línea. Los pasos completos están en la configuración inicial del manual del operador.

Recomendado: mantén tu comunidad en marcha cuando Docker se actualice

El paso está en la página «Updates and health» del manual del operador. Un asistente de IA que haga la instalación siempre ejecuta este paso (Configurar tu servidor con un asistente de IA).

Ver en GitHub →