Timestamps de Git autoalojados: configuración de Docker y guía de licencias
Ya has visto cómo la GitHub App ancla cada commit en Bitcoin durante la noche. Ahora llega la pregunta de compra: ¿dejas que Timestamp GIT aloje el pipeline, o ejecutas la imagen de Docker dentro de tu propia red y gestionas tú mismo la licencia?
Esta guía está escrita para la decisión de compra, no para la criptografía. Si estás sopesando una licencia autoalojada de Timestamp GIT Docker frente a los planes gestionados, esto es lo que realmente te ofrece cada opción, cómo es la configuración y hacia dónde lleva la ruta de actualización.
La decisión de compra: cuándo tiene sentido autoalojar los timestamps de Git
Ambos modos de despliegue producen los mismos recibos .ots listos para un tribunal, anclados en Bitcoin. La decisión es operativa, no criptográfica: estás eligiendo dónde se ejecuta el pipeline de procesamiento, no qué prueba produce.
El autoalojamiento suele ganar en tres situaciones:
- Redes aisladas o restringidas. Tu infraestructura de compilación no tiene ruta hacia SaaS de terceros, pero sí puede alcanzar una salida controlada para el tráfico de Bitcoin y de calendarios.
- Industrias reguladas. Los equipos de cumplimiento quieren que los hashes de commit —incluso los hashes— permanezcan dentro de un perímetro definido con un flujo de datos documentado.
- Requisitos de residencia de datos. Una política que dice “ningún metadato sale de la región” es más fácil de cumplir cuando el servicio se ejecuta en tu propio rack.
Hay una idea errónea común que conviene aclarar: el autoalojamiento no significa que tu equipo ejecute el protocolo de timestamping a mano. No estás instalando herramientas en las máquinas de los desarrolladores, ni estás programando nada contra la blockchain. La imagen de Docker empaqueta el flujo de trabajo gestionado completo —detección de commits, agrupación nocturna, construcción del árbol de Merkle, anclaje en Bitcoin— detrás de un asistente de configuración. La forma difícil sería enseñar a cada desarrollador una CLI de protocolo; la forma del producto es un único archivo Docker Compose.
Si tu equipo todavía está decidiendo si vale la pena comprar la prueba criptográfica, empieza por ¿Qué es la técnica anterior criptográfica? Una guía para equipos de software y vuelve aquí para las cuentas de la licencia.
Qué obtienes en cada plan: Open Source, Pro Agency, Enterprise ZK y Docker autoalojado
| Plan | Precio | Qué obtienes |
|---|---|---|
| Open Source | Gratis | Repositorios públicos, instalación de la GitHub App, anclaje nocturno automático |
| Pro Agency | $49/mes | Repositorios privados, insignias de verificación, acceso a la REST API, descargas de CSV de auditoría y certificados PDF |
| Enterprise ZK | $199/mes | Una GitHub Action de 12 líneas que envía únicamente el hash del commit desde tu infraestructura |
| Docker autoalojado | Licencia requerida | El mismo producto como imagen de Docker, con una licencia de demostración por tiempo limitado para evaluación |
El plan Open Source es la vía honesta de evaluación. Instala la GitHub App en un repositorio público, observa cómo llega el anclaje nocturno y comprueba si el flujo de trabajo encaja con tu equipo antes de que cambie de manos ningún dinero.
Pro Agency es el plan en el que aterrizan la mayoría de las agencias y empresas de producto: repositorios privados, la insignia y la superficie de la REST API, y los artefactos de cumplimiento descargables —el CSV del libro de auditoría y el certificado PDF por fecha— que piden los equipos legales y de compras.
Enterprise ZK es el punto intermedio entre la nube y el autoalojamiento. Una pequeña GitHub Action se ejecuta en tus runners y envía únicamente el hash del commit a la API de Timestamp GIT. El servicio nunca tiene acceso de lectura al repositorio de origen, así que tu código permanece dentro de tu perímetro mientras el pipeline de anclaje sigue siendo gestionado.
Para los detalles de instalación —flujo OAuth, selección de repositorios, permisos— consulta Configuración del timestamp blockchain de la GitHub App: instala una vez, sella para siempre. Este artículo se centra en la licencia autoalojada y en cómo se compara.
Coste, beneficio y ROI: por qué la prueba criptográfica es más barata que el litigio
Una licencia autoalojada es una partida que puedes presupuestar. Una disputa de propiedad intelectual no lo es.
Compara la licencia con el escenario adverso: reclamaciones de trolls de patentes en las que implementaste la tecnología meses antes de la presentación pero no tienes más que registros internos editables; disputas de autoría entre empleados en las que la única evidencia es un “dijo, dijo” sobre cuándo se concibió una funcionalidad; y defensas de sala limpia frente a competidores que alegan desarrollo independiente. Un timestamp de hace 18 meses es un muro contra el que chocan esas reclamaciones.
Dos propiedades hacen que la prueba sea lo bastante duradera como para merecer que se pague por ella:
- Independencia del proveedor. La prueba se basa únicamente en SHA-256 y en los datos de los bloques de Bitcoin. Sigue siendo verificable sin conexión aunque el proveedor desaparezca. Eso es algo genuinamente raro que poder decirle a un equipo de compras adverso al riesgo.
- Seguridad de conocimiento cero. En el modo Docker autoalojado, todo el pipeline se ejecuta en tu infraestructura. En el modo Enterprise ZK, solo el hash del commit sale de tu entorno. El código fuente nunca es leído, copiado ni almacenado por el servicio.
También hay una partida de coste que la mayoría de los equipos olvida comprobar: las herramientas por asiento. Timestamp GIT no requiere nada instalado en las máquinas de los desarrolladores. No hay CLI que distribuir, ni plugin de IDE que mantener, ni interrupción del flujo de trabajo que reenseñar, lo que significa que el coste real es la licencia, no el despliegue.
Configuración de Docker autoalojado: inicio rápido para equipos aislados y on-premise
Una configuración rápida de Docker Compose tiene este aspecto:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
Dos servicios: la imagen de la aplicación y el almacén clave-valor usado para la cola de hashes. Luego lo levantas:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
Una vez que el contenedor está sano, la aplicación está disponible en http://localhost:8080. En el primer arranque, un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia, sin editar archivos de configuración a mano.
Dos detalles importan para la operación desatendida:
- El montaje del volumen.
./data:/app/dataes donde vive el almacenamiento persistente de pruebas. Haz copias de seguridad con el mismo rigor que con los datos de tu repositorio; es lo que hace que tu instancia sea reproducible tras un fallo del host. - La política de reinicio.
restart: unless-stoppedmantiene vivo el worker cron nocturno a través de los reinicios, que es lo que hace que la promesa de “configúralo y olvídate” se sostenga de verdad.
Para evaluar antes de comprometerte con una licencia de producción, envía el formulario de solicitud en la página de licencia de Docker con tu nombre, empresa, correo electrónico y número de teléfono opcional. Hay disponible para descarga un archivo de licencia de demostración por tiempo limitado, para que puedas ejecutar primero una instancia real contra un repositorio real.
Autoalojado vs. nube gestionada: elegir tu ruta de actualización
Ruta SaaS gestionada. Instala la GitHub App una vez. Los commits se detectan mediante webhooks, se agrupan con el worker cron de medianoche y se anclan automáticamente. Los manifiestos y los archivos de recibo .ots se envían de vuelta a una rama dedicada de timestamps o a un repositorio en la sombra. Las insignias, el panel de estado y la REST API están incluidos.
Ruta Enterprise ZK. La misma automatización, pero el envío del hash del commit se origina desde tu propia GitHub Action. El servicio solo requiere acceso de lectura y escritura al repositorio de destino, sin acceso de lectura al repositorio de origen.
Ruta Docker autoalojada. De nuevo la misma automatización, con el pipeline de procesamiento ejecutándose por completo en tu infraestructura para un control máximo.
Las expectativas de tiempos son idénticas en las tres: el worker nocturno agrupa los hashes pendientes, construye un árbol de Merkle de forma nativa, crea las pruebas usando los calendarios públicos de OTS y ancla la raíz de Merkle en Bitcoin. La confirmación de Bitcoin suele tardar unas tres horas, así que la escritura de la prueba se completa unas horas después de que se ejecute el cron. Nada por lo que quedarse despierto.
Verificación, insignias y artefactos de auditoría después de comprar
La verificación es local y de conocimiento cero. La página de verificación basada en navegador en /verification/{user}/{repo}/{date} calcula la cadena de Merkle paso a paso, con toda la computación ocurriendo en el navegador. Nadie ve lo que verificas. Para el recorrido criptográfico en sí, lee Cómo verificar localmente una prueba de timestamp de Bitcoin; esta sección trata de los artefactos que obtienes después de la compra.
- Panel de estado público (
/status/{user}/{repo}): longevidad de las pruebas, fecha del primer anclaje, regularidad diaria, datos de bloques y transacciones de Bitcoin, y un mapa de calor de calendario. - CSV del libro de auditoría: extrae el libro completo para la revisión de cumplimiento.
curl -o audit.csv "https://timestampgit.dev/api/audit/your-user/your-repo"
- Certificado PDF por fecha: descarga un certificado de un solo día para revisión legal.
curl -o certificate.pdf "https://timestampgit.dev/api/report/your-user/your-repo/2026-10-18"
- Insignias de Shields.io para tu README, con vista previa en vivo durante la configuración en
/connected/{user}/{repo}y fragmentos de markdown desde/api/badgeLink/{user}/{repo}. Los repositorios privados añaden un HMAC cifrado a la URL de la insignia, de modo que solo los usuarios autorizados pueden ver el estado.
Los endpoints de estado públicos como /api/statusSummary/{user}/{repo} son los que alimentan la insignia, así que una inserción puede mostrar un anclaje verificado sin exponer nada más.
Preguntas frecuentes
¿Tengo que ejecutar comandos de OpenTimestamps yo mismo si autoalojo la imagen de Docker?
No. La imagen de Docker empaqueta el flujo de trabajo gestionado completo: detección de commits, agrupación nocturna, construcción del árbol de Merkle y anclaje en Bitcoin mediante los calendarios públicos de OTS. Lo configuras a través del asistente de configuración y recibes los recibos .ots automáticamente. El protocolo subyacente permanece oculto, exactamente igual que en el SaaS gestionado.
¿Cómo obtengo una licencia para el despliegue de Docker autoalojado? Envía el formulario de solicitud en la página de licencia de Docker con tu nombre, empresa, correo electrónico y número de teléfono opcional. Hay disponible para descarga un archivo de licencia de demostración por tiempo limitado, para que puedas evaluar la instancia antes de comprometerte con una licencia de producción.
¿El autoalojamiento significa que mi código fuente queda expuesto al proveedor? No. En el modo Docker autoalojado, todo el pipeline se ejecuta en tu infraestructura. En el modo Enterprise ZK gestionado, una GitHub Action de 12 líneas envía únicamente el hash del commit, así que el servicio nunca tiene acceso de lectura a tu repositorio de origen. El código fuente nunca sale de tu entorno en ninguno de los dos casos.
¿El autoalojamiento cambia el peso legal de la prueba?
No. La prueba está basada en Bitcoin. Los recibos .ots y los archivos de manifiesto se verifican contra los datos de los bloques de Bitcoin independientemente de qué despliegue los produjo, así que el modo de despliegue es una elección operativa, no probatoria.
¿Qué pasa con mis pruebas si dejo de usar el servicio?
Tus archivos de recibo .ots y tus archivos de manifiesto viven en tu repositorio o en tu repositorio en la sombra y siguen siendo verificables sin conexión usando las herramientas estándar de OpenTimestamps contra la blockchain de Bitcoin. La prueba se basa únicamente en SHA-256 y en los datos de los bloques de Bitcoin, así que sigue siendo válida aunque el proveedor desaparezca.
Conclusión
Autoaloja la imagen de Docker cuando el cumplimiento, el aislamiento de red o la residencia de datos lo exijan. Elige Enterprise ZK cuando quieras anclaje gestionado pero sin acceso de lectura al repositorio. Quédate en los planes gestionados cuando la simplicidad operativa valga más que el control del perímetro. En los tres casos, el recibo que acabas teniendo en la mano es el mismo.
¿Listo para evaluar? Solicita una licencia de demostración por tiempo limitado, levanta la instancia con el archivo Compose de arriba y observa cómo llega tu primer anclaje nocturno unas horas después del cron.
Entradas relacionadas
- Configuración del timestamp blockchain de la GitHub App: instala una vez, sella para siempre
- ¿Son fiables los timestamps de commit de Git como prueba legal?
- Cómo verificar localmente una prueba de timestamp de Bitcoin