Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar y usar DocuSeal: Alternativa open source a DocuSign para firma digital de documentos en el canal GENBYTE:

¿Qué es DocuSeal: Alternativa open source a DocuSign para firma digital de documentos?

DocuSeal es una plataforma open source que proporciona firma y procesamiento seguro y eficiente de documentos digitales. Permite crear formularios PDF para que sean rellenados y firmados en línea desde cualquier dispositivo mediante una herramienta web fácil de usar y optimizada para móviles. Está distribuida bajo licencia AGPLv3 con términos adicionales y desarrollada principalmente en Ruby on Rails con frontend en Vue y TailwindCSS.

Características principales

Requisitos del sistema

• Docker y Docker Compose instalados
• Servidor con arquitectura x86_64 o aarch64
• Mínimo 2 GB de RAM recomendados
• Espacio en disco para base de datos PostgreSQL y almacenamiento de documentos
• Puerto 80 y 443 disponibles para Caddy (HTTPS automático)
• Puerto 3000 para la aplicación si se expone directamente
• Dominio configurado con DNS apuntando al servidor para certificados SSL automáticos

Instalación con Docker Compose

Descargar docker-compose.yml

Obtener el archivo de composición oficial del repositorio.

Levantar la stack con dominio personalizado

Inicia los contenedores (app, PostgreSQL, Caddy) con HTTPS automático mediante Let's Encrypt. Requiere que el DNS del dominio apunte al servidor.

Despliegue simple con SQLite (sin dominio)

Ejecución directa del contenedor usando base de datos SQLite integrada, accesible en puerto 3000.

Acceder al proyecto

Acceso vía HTTPS con dominio

Tras el despliegue con HOST=tu-dominio.com, la aplicación está disponible en https://tu-dominio.com. Caddy gestiona certificados TLS automáticamente.

Acceso directo por puerto (desarrollo/pruebas)

Si se usa docker run simple o docker compose sin variable HOST, la interfaz web responde en http://localhost:3000 o http://IP_DEL_SERVIDOR:3000.

Casos de uso

• Firma de contratos y acuerdos en sectores bancario, sanitario, inmobiliario, transporte y eCommerce
• Procesos KYC y onboarding de clientes con verificación de identidad
• Integración en CRM y software de gestión para envío masivo de documentos (CSV, XLSX)
• Firma embebida en aplicaciones web o móviles propias mediante SDKs (React, Vue, Angular, JavaScript)
• Automatización de flujos de trabajo con recordatorios, campos condicionales y fórmulas
• Cumplimiento normativo de firma electrónica en múltiples jurisdicciones

Configuración avanzada

Configurar base de datos externa

Por defecto usa PostgreSQL en el compose. Para usar MySQL o PostgreSQL externo, define la variable DATABASE_URL en el servicio app.

Almacenamiento en cloud (S3, GCS, Azure)

Configura variables de entorno para usar proveedores de almacenamiento de objetos en lugar del disco local. Consulta la documentación oficial para las variables exactas.

Configuración SMTP para emails

Define variables de entorno del servidor SMTP para habilitar notificaciones y recordatorios automáticos.

Forzar HTTPS sin Caddy

Si se usa proxy inverso externo, la variable FORCE_SSL=true obliga a la app a generar URLs seguras.

Gestión y mantenimiento

Actualizar a nueva versión

Descargar la imagen más reciente y recrear contenedores manteniendo volúmenes de datos.

Backup de base de datos PostgreSQL

Ejecutar pg_dump dentro del contenedor de base de datos para respaldar datos.

Backup de archivos subidos

Copiar el volumen de datos de la aplicación que contiene documentos y configuración.

Ver logs de la aplicación

Consultar logs de los servicios para diagnóstico.

Stack técnico

• Ruby 4.0.5
• Ruby on Rails
• Vue 3
• TailwindCSS
• PostgreSQL 18
• Caddy (reverse proxy + TLS automático)
• PDFium (renderizado PDF)
• ONNX Runtime (detección de campos IA)
• Puma (servidor de aplicaciones)
• Shakapacker (webpack para Rails)
• Yarn (gestor de paquetes JS)
• Docker / Docker Compose

Apoya el canal GENBYTE

Sígueme en mis redes sociales