Saltar al contenido principal
Versión: 0.1.0

Inicio rapido

Este es el camino mas rapido desde cero hasta tener una instancia de Openbeehive en funcionamiento que puedas abrir en un navegador. Elige una de las dos rutas:

  • Opcion A — Binario unico. Compila un unico binario autocontenido que usa SQLite y el sistema de archivos local. Sin Docker, sin servidor de base de datos, sin almacenamiento de objetos. Ideal para un servidor domestico, una Raspberry Pi o un pequeno VPS.
  • Opcion B — Docker. Descarga nuestra imagen publicada y ejecutala con un solo comando.

Ambas rutas usan el perfil de despliegue selfhost, que utiliza por defecto una base de datos SQLite embebida y almacenamiento de blobs en el sistema de archivos. Mas adelante puedes cambiar a PostgreSQL y MinIO/S3 — consulta Configuracion.

:::tip ¿Un solo usuario? No hace falta inicio de sesion Si eres la unica persona que usa tu instancia, puedes ejecutarla sin autenticacion alguna. Simplemente deja BEEHIVE_OIDC_PROVIDERS vacio y manten BEEHIVE_WEBAUTHN_ENABLED=false (ambos son los valores por defecto). La aplicacion se abre directamente en tus registros. Para anadir el inicio de sesion mas tarde, consulta Autenticacion. :::

La configuracion minima funcional​

Sea cual sea la ruta que elijas, solo dos ajustes importan realmente para empezar:

BEEHIVE_DEPLOYMENT_PROFILE=selfhost
BEEHIVE_PUBLIC_BASE_URL=http://localhost:8080

BEEHIVE_PUBLIC_BASE_URL es la direccion que la gente (y los enlaces directos de los codigos QR) usan para acceder a la aplicacion. Para pruebas locales, http://localhost:8080 esta bien. Para un despliegue real, configuralo con tu URL publica, por ejemplo https://bees.example.com.

Todo lo demas tiene valores por defecto sensatos para el alojamiento propio. La lista completa esta en Configuracion.

Opcion A — Binario unico (sin Docker)​

Requisitos previos​

  • Go 1.25 o mas reciente
  • Node 22 o mas reciente
  • buf

Compilar y ejecutar​

git clone https://github.com/johnnycube/openbeehive-app.git
cd openbeehive

# Generate the Connect-RPC code, then build the server
make proto
make build

# Configure
cp .env.example .env
# Edit .env: set BEEHIVE_DEPLOYMENT_PROFILE=selfhost and BEEHIVE_PUBLIC_BASE_URL

# Run
./server/bin/openbeehive

Por defecto, el binario escucha en :8080 y sirve la propia aplicacion web (BEEHIVE_SERVE_WEB=true), de modo que la API y la PWA provienen del mismo origen. Abre la direccion indicada en BEEHIVE_PUBLIC_BASE_URL y ya estaras dentro.

:::note Donde residen tus datos En modo selfhost, tus registros van a un archivo SQLite local y las fotos subidas a un directorio de blobs (./data/blobs por defecto). Haz copia de seguridad de estos y habras respaldado todo — consulta Copias de seguridad. :::

Opcion B — Docker​

Si tienes Docker instalado, esta es la ruta mas rapida de todas. La imagen publicada es ghcr.io/johnnycube/openbeehive-app:latest.

docker run -d \
  --name openbeehive \
  -p 8080:8080 \
  -e BEEHIVE_DEPLOYMENT_PROFILE=selfhost \
  -e BEEHIVE_PUBLIC_BASE_URL=http://localhost:8080 \
  -v openbeehive-data:/data \
  ghcr.io/johnnycube/openbeehive-app:latest

El volumen -v openbeehive-data:/data mantiene tu base de datos SQLite y tus blobs fuera del contenedor, de modo que sobreviven a las actualizaciones y reinicios. Una vez en marcha, abre http://localhost:8080.

Para detenerlo o eliminarlo:

docker stop openbeehive
docker rm openbeehive

:::tip ¿Prefieres la pila cloud? Los comandos anteriores ejecutan el perfil ligero selfhost. Si quieres el perfil completo cloud (PostgreSQL + MinIO), el repositorio incluye un archivo Compose — ejecuta docker compose up -d. Consulta Docker para los detalles. :::

Primeros pasos despues de la instalacion​

Ya tienes una instancia en funcionamiento. A partir de aqui:

  1. Abre la aplicacion en tu BEEHIVE_PUBLIC_BASE_URL y crea tu primer colmenar.
  2. Anade una colmena, elige su tipo y registra una inspeccion.
  3. Opcionalmente, imprime una etiqueta QR para la colmena para poder escanearla directamente sobre el terreno.

Para un recorrido por la propia aplicacion, dirigete a Uso de la aplicacion. Para preparar tu instancia para produccion — HTTPS, un dominio real, autenticacion y copias de seguridad — continua con:

:::caution Usa HTTPS en produccion http://localhost solo es adecuado para pruebas locales. Exponer la aplicacion en internet sin TLS pone en riesgo tus datos y rompe funciones que requieren un contexto seguro. Configura BEEHIVE_PUBLIC_BASE_URL con una direccion https:// y termina el TLS en un proxy inverso antes de ponerla en produccion. :::