Hypothesis (autoalojado)

Hypothesis es una herramienta de anotación web de código abierto. h es el servidor que la hace funcionar: sirve la aplicación web de anotación y la API pública de anotaciones. Con una instancia autoalojada, tú y tus colaboradores podéis resaltar, anotar y debatir cualquier página web o PDF en una infraestructura que controláis.

Esta plantilla despliega cuatro servicios como un único stack de un clic:

• hypothesis — el servidor h (aplicación web, API, WebSocket en tiempo real y worker en segundo plano)
• postgresql — almacena cuentas, grupos y anotaciones
• elasticsearch — potencia la búsqueda de anotaciones (usa la compilación de Hypothesis con ICU incluido)
• rabbitmq — broker de mensajes para el worker en segundo plano

Primeros pasos

1. Introduce el dominio que quieras usar y haz clic en Deploy.
2. Espera a que los cuatro servicios terminen de desplegarse. El servicio hypothesis ejecuta una inicialización única en el primer arranque (esquema de base de datos, índice de búsqueda y cuenta de administrador), por lo que su primer arranque tarda unos minutos: esto es normal.
3. Abre tu dominio. Deberías ver la página de inicio de Hypothesis.

Iniciar sesión

Se crea automáticamente una cuenta de administrador en el primer arranque:

• Usuario: admin
• Contraseña: consulta la variable ADMIN_PASSWORD del servicio hypothesis (pestaña Variables en el panel de Zeabur)

Inicia sesión en https://TU_DOMINIO/login y cambia esta contraseña de inmediato desde la página de ajustes de la cuenta. Las herramientas de administración están en https://TU_DOMINIO/admin.

Usar un dominio personalizado

La "authority" de las anotaciones y la URL pública se derivan del dominio en el momento del despliegue. Si quieres usar un dominio personalizado, vincúlalo antes de tu primer despliegue, o prepárate para volver a desplegar: cambiar el dominio cuando ya existen cuentas y anotaciones las dejará ligadas a la authority antigua.

Notas importantes

• El cliente de anotación se carga desde https://cdn.hypothes.is. Es el comportamiento predeterminado de Hypothesis y mantiene el cliente actualizado; tus datos de anotación permanecen íntegramente en tu propia instancia.
• El correo no está configurado. Se omite la activación de cuentas y no se enviarán correos de restablecimiento de contraseña a menos que añadas variables de entorno MAIL_* al servicio hypothesis.
• Los datos residen en los volúmenes de postgresql y elasticsearch. El servicio hypothesis en sí no tiene estado. No elimines esos volúmenes.
• Los servicios PostgreSQL, Elasticsearch y RabbitMQ solo son accesibles dentro de la red privada del proyecto; Elasticsearch en particular no tiene autenticación, así que no lo expongas públicamente.

Atribución y licencia

Hypothesis (h) está desarrollado por el Hypothes.is Project y sus colaboradores, y se publica bajo la licencia BSD-2-Clause. Esta plantilla solo empaqueta la imagen Docker oficial hypothesis/hypothesis para su despliegue en Zeabur; no está afiliada ni respaldada por el Hypothes.is Project.

• Código fuente: https://github.com/hypothesis/h
• Sitio web oficial: https://web.hypothes.is/

Registro de cambios

• 2026-05-14: Lanzamiento inicial. Basado en hypothesis/hypothesis:20260504-g4d0056f.