Docs

Alojamiento propio

Qué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.

Aplica a Motor Al lanzar

Ver como Markdown
En esta página
  1. Qué corres
  2. Dos formas de desplegar
  3. Qué necesitas
  4. Cuánto cuesta
  5. Qué no tienes
  6. Qué debe estar corriendo para cada función
  7. Las páginas de esta sección
  8. El orden a seguir
  9. Pruébalo en tu máquina
  10. Despliégalo donde va a vivir
  11. Recorre la lista de seguridad
  12. Configura los respaldos y luego decide la retención
  13. Conecta las piezas opcionales

Motor Esta sección es para quien va a correr el motor de código abierto en su propia infraestructura. Nada de aquí aplica a Sypnia Cloud, donde nosotros corremos el mismo motor por ti. Si solo quieres probar el motor en tu computador, empieza por el inicio rápido con alojamiento propio y vuelve aquí antes de ponerle tráfico real.

Qué corres

Tres cosas, y nada más:

PiezaQué esQué guarda
El motorUn programa, sypnia. Recibe eventos, los procesa, responde la API y el servidor MCP, y sirve la Consola.Nada. No guarda estado propio.
Un bucketCualquier almacenamiento de objetos compatible con S3: Amazon S3, Cloudflare R2, MinIO.Eventos crudos, fragmentos de grabación, capturas de página, source maps.
Una base de datos PostgresVersión 15 o posterior: Amazon RDS, Supabase, Neon o tu propio servidor.Los problemas, el índice de sesiones, los números por hora y por día, los proyectos, las llaves, los tokens y la configuración.

Qué más hay depende de la forma en que despliegues:

  • Como un solo proceso de larga duración (Docker, o cualquier servidor): nada además del motor, Postgres y el bucket. Ni cola, ni caché, ni servidor de búsqueda.
  • Con la plantilla de AWS: el motor corre como tres funciones, y la plantilla crea además una programación y una cola administrada entre la ingesta y el worker. No operas ninguna de las dos: no hay nada que parchar, dimensionar ni reiniciar.

Por qué bastan dos almacenes está en Cómo está construido el motor, y las dos formas lado a lado están en Formas de despliegue.

Cada pieza que depende de un proveedor la eliges tú. Dos de ellas, la entrega de alertas y el proveedor de IA, están apagadas hasta que las conectas, y el motor funciona sin ninguna de las dos:

Almacenamiento de objetos

Guarda los eventos crudos, los fragmentos de grabación, las capturas de página y los source maps.

Despliegue por defecto
El bucket que crea la plantilla.
Alternativas que explica la documentación
Cualquier almacenamiento compatible con S3: Amazon S3, Cloudflare R2, MinIO.
Sypnia Cloud usa
Amazon S3.

Base de datos

Guarda los agregados, el índice de sesiones, los problemas y la configuración.

Despliegue por defecto
Una URL de Postgres que das tú, o la que crea la plantilla.
Alternativas que explica la documentación
Amazon RDS, Supabase, Neon o tu propio servidor.
Sypnia Cloud usa
Postgres.

Entrega de alertas

Lleva una alerta del motor a una persona.

Despliegue por defecto
Ninguna. Las alertas quedan registradas, y se envían a un webhook si configuras uno.
Alternativas que explica la documentación
Recetas: correo con Amazon SES, correo con cualquier servidor SMTP, o tu propia función sobre el webhook.
Sypnia Cloud usa
Correo con Amazon SES, y alertas dentro de la app.

Proveedor de IA

Corre el modelo detrás del análisis del agente y del prompt listo.

Despliegue por defecto
Apagado hasta que pongas una llave.
Alternativas que explica la documentación
OpenRouter, la API de OpenAI, la API de Anthropic, Google Gemini, o cualquier endpoint compatible con OpenAI, alojado o local.
Sypnia Cloud usa
OpenRouter.

Pull requests

Abre el pull request con el arreglo.

Despliegue por defecto
No está en el motor.
Alternativas que explica la documentación
Usa el prompt o el servidor MCP con tu propio agente de código.
Sypnia Cloud usa
La Sypnia GitHub App.

Dos formas de desplegar

El mismo binario corre de dos formas. Elige según lo que ya operas.

Desplegar en AWSDesplegar con Docker
Qué correTres funciones (ingesta, API, worker), una cola administrada, una programación, un bucket y una dirección por delante, todo creado por la plantilla. Postgres lo crea la plantilla o lo traes tú.Un proceso de larga duración, sypnia serve, junto a un Postgres y un bucket.
Qué cuidas túCasi nada entre una actualización y otra. No hay servidor que parchar.Un servidor: su disco, sus actualizaciones, sus reinicios.
Sirve cuandoEl tráfico llega por ráfagas, o ya vives en AWS.Tienes un servidor, quieres una factura que no se mueva, o no usas AWS.
Montaje sensato más pequeñoLos valores por defecto de la plantilla.2 vCPU, 4 GB de memoria y 40 GB de disco para todo en una sola máquina (una estimación; ver Escalado y costo).
Sypnia Cloud usaEsta forma, en us-east-1.

Puedes pasar de una a la otra más adelante: ambas leen la misma estructura del bucket y el mismo esquema de base de datos.

Qué necesitas

  • Un dominio y HTTPS. Los navegadores envían a la dirección del motor, y esa dirección queda escrita en tu app. Elígela una sola vez: https://sypnia.example.com.
  • Una cuenta con un proveedor de nube, o un servidor. Para AWS, permiso para crear funciones, un bucket, una cola y roles. Para Docker, una máquina Linux con Docker y Compose.
  • Alguien que sepa restaurar un respaldo de Postgres. La base de datos guarda lo que no se puede reconstruir: tus proyectos, llaves, tokens, y lo que las personas marcaron en los problemas. Ver Actualizaciones, respaldos y retención.
  • Cerca de una hora para el primer despliegue, y unos minutos para cada actualización.
  • Una llave de modelo, solo si quieres la frase en palabras simples. Sin ella el motor funciona, y los problemas conservan su título técnico. Ver Modelos y qué se envía.

No necesitas una cuenta de Sypnia. Un motor con alojamiento propio nunca se comunica con Sypnia, la empresa: no hay verificación de licencia, ni reporte de uso, ni telemetría.

Cuánto cuesta

El motor es gratis: no hay costo de licencia ni límite puesto por nosotros a los proyectos, eventos, grabaciones o retención. Le pagas a tu propio proveedor.

TamañoTráficoEn AWSUn servidor con Docker
PequeñoCerca de 1.000 sesiones y 130.000 eventos al día (4 millones de eventos al mes)Cerca de USD 22 al mes, casi todo la base de datosCerca de USD 25 a 30 al mes
MedianoCerca de 10.000 sesiones y 1,3 millones de eventos al día (40 millones de eventos al mes)Cerca de USD 60 a 85 al mesCerca de USD 60 a 75 al mes

Son estimaciones, no cotizaciones. La aritmética de cada número, qué lo mueve, y las cifras medidas en el sistema del que sale este motor están en Escalado y costo.

Qué no tienes

El motor hace todo el trabajo de recibir, guardar y analizar. Lo que agrega Sypnia Cloud es todo lo que lo rodea. Si alojas tú, nada de esto existe a menos que lo construyas:

Sypnia Cloud tieneUn motor con alojamiento propio tiene
La app completa: pantallas de rendimiento, disponibilidad y mapas de clics, búsqueda, el resumen diarioLa Consola: la lista de problemas y el visor de grabaciones de sesión. Todo lo demás son datos que lees por la API, la CLI o el servidor MCP.
Usuarios, organizaciones y rolesProyectos, llaves de ingesta y tokens de API. Quien tiene un token, entra.
Alertas por correo y dentro de la appAlertas registradas, y enviadas a un webhook si configuras uno. El despliegue por defecto no envía correos. Receta: Correos de alerta desde un motor con alojamiento propio.
El resumen diario por correoNo hay correo de resumen. GET /v1/summary devuelve lo que está fallando ahora.
El agente, con un modelo incluidoEl agente, apagado hasta que pongas tu propia llave de modelo.
Pull requests abiertos por la Sypnia GitHub AppNo hay pull requests. Usa el prompt o el servidor MCP con tu propio agente de código.
Comprobaciones de disponibilidad desde tres regionesComprobaciones de disponibilidad desde el único lugar donde corre tu worker.
Actualizaciones, respaldos y capacidad a cargo nuestroA cargo tuyo.
Soporte por correo en los planes pagosSoporte de la comunidad, en el repositorio del motor.

No hay integración con WhatsApp ni con Slack en ninguno de los dos.

Qué debe estar corriendo para cada función

Un solo proceso iniciado con sypnia serve lo corre todo. Si divides el motor en roles, o lo corres como funciones, esto es lo que necesita cada función:

FunciónNecesita
Recibir eventos, fragmentos de grabación y trazas de OpenTelemetryEl rol ingest, alcanzable desde los navegadores en tu URL base.
Problemas nuevos, sesiones, números, alertas, webhooks, retenciónEl rol worker, o sypnia aggregate ejecutado cada minuto por tu propio programador de tareas.
Comprobaciones de disponibilidadEl rol worker, y SYPNIA_UPTIME_ENABLED en true. Las comprobaciones se hacen desde la máquina o la región donde corre el worker, así que ve tu app desde un solo lugar. Si el worker comparte servidor con la app que vigila, una caída de ese servidor detiene también las comprobaciones: córrelas desde otro lugar. Las direcciones privadas y de loopback se rechazan a menos que actives SYPNIA_UPTIME_ALLOW_PRIVATE_ADDRESSES.
La API, el servidor MCP y la ConsolaEl rol api.
La frase en palabras simplesEl rol worker y un proveedor de IA.

Los roles son una opción de sypnia serve. El valor por defecto, all, es cada fila de esta tabla en un solo proceso.

Las páginas de esta sección

  • Desplegar en AWS

    Despliega el motor de Sypnia en tu propia cuenta de AWS con una sola plantilla de CloudFormation, compruébalo, crea el primer proyecto, apúntale un dominio, actualízalo y elimínalo.

  • Desplegar con Docker

    Corre el motor de Sypnia en cualquier servidor con Docker Compose, junto a un Postgres y un almacenamiento compatible con S3, con HTTPS, un primer proyecto, sus llaves y una comprobación de salud.

  • Referencia de configuración

    Cada ajuste del motor de Sypnia: su variable de entorno, su tipo, su valor por defecto y qué cambia, con las opciones de cada pieza que tú eliges.

  • Estructura del almacenamiento

    Dónde guarda cada tipo de dato un motor con alojamiento propio, cuánto espacio ocupa, cómo medirlo, y qué reglas ponerle al bucket y cuáles evitar.

  • La Consola

    Qué muestra la única página integrada del motor, cómo abrirla con un token de API, cómo protegerla o apagarla, y qué no hace frente a la app de Sypnia Cloud.

  • Actualizaciones, respaldos y retención

    Cómo actualizar un motor con alojamiento propio sin perder datos, qué respaldar y cómo restaurarlo, y cómo elegir cuánto tiempo se guarda cada tipo de dato.

  • Escalado y costo

    Cuánto cuesta al mes un motor con alojamiento propio para un proyecto pequeño y uno mediano, con la aritmética, qué mueve la factura, los primeros límites que encuentras, y cuándo pasar de un proceso a varios o a funciones.

  • Lista de seguridad

    Qué cerrar en un motor con alojamiento propio antes de que le llegue tráfico real, cada punto con el ajuste o el comando que lo hace y la comprobación que lo demuestra.

El orden a seguir

  1. Pruébalo en tu máquina

    Sigue el inicio rápido con alojamiento propio. Toma unos quince minutos y te muestra cada pieza en movimiento.

  2. Despliégalo donde va a vivir

    Desplegar en AWS o Desplegar con Docker. Ambos terminan con sypnia doctor en verde y un primer proyecto.

  3. Recorre la lista de seguridad

    La lista de seguridad es corta. Hazla antes de apuntar una app real al motor.

  4. Configura los respaldos y luego decide la retención

    Actualizaciones, respaldos y retención.

  5. Conecta las piezas opcionales

    Una llave de modelo para el agente, y un webhook para las alertas. Las dos están en la referencia de configuración.

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar