DocuSeal | eSignature | Docker
DocuSeal: Alternativa open source a DocuSign para firma digital de documentos
Crea, rellena y firma documentos digitales de forma segura. Formularios PDF personalizables, firma electrónica, certificados de completion y API completa.
¿Qué es DocuSeal?
DocuSeal es una
plataforma open source de firma electrónica que te permite crear, rellenar y firmar documentos digitales. Es una alternativa autohospedada y de código abierto a servicios comerciales como DocuSign, HelloSign o PandaDoc.
Con DocuSeal puedes diseñar formularios PDF arrastrando y soltando campos (firmas, texto, fechas, checkboxes), enviar documentos para firma a múltiples participantes, realizar seguimiento del estado de firma, y recibir documentos completados con certificados de completion válidos legalmente. Todo ejecutándose en tu propio servidor con control total sobre tus datos.
Privacidad y soberanía: A diferencia de servicios cloud propietarios, DocuSeal te da control absoluto sobre tus documentos sensibles. Ideal para industrias reguladas como banca, sanidad, legal y gobierno donde la privacidad de datos es crítica.
Características principales
Constructor drag & drop
Diseña formularios PDF arrastrando campos: firma, texto, fecha, checkbox, iniciales, imagen, archivo adjunto.
Firma múltiple
Múltiples firmantes en orden secuencial o paralelo con roles personalizables.
Campos condicionales
Campos que aparecen/desaparecen según las respuestas de otros campos.
Plantillas reutilizables
Crea plantillas de documentos que puedes reutilizar con diferentes firmantes.
Firma embebida
Integra el proceso de firma directamente en tu aplicación web via iframe o componente React/Vue.
API REST completa
Automatiza completamente el flujo de firma con API documentada y SDKs oficiales.
Webhooks
Recibe notificaciones en tiempo real cuando documentos son vistos, firmados o completados.
Certificado de completion
Cada documento completado genera un certificado PDF con hashes criptográficos y timestamps.
Autenticación de firmantes
Códigos de acceso, autenticación por email, SMS (con Twilio) para verificar identidad.
Recordatorios automáticos
Envío automático de recordatorios a firmantes que no han completado el documento.
Firma en cualquier orden
Flujos secuenciales (firmante A → B → C) o paralelos (todos a la vez).
Multiidioma
Interfaz en múltiples idiomas incluyendo español, inglés, francés, alemán y más.
Instalación rápida
Opción 1: Docker Run (prueba rápida)
docker run --name docuseal -p 3000:3000 \
-v docuseal-data:/data \
docuseal/docuseal
Accede a http://localhost:3000 y crea tu cuenta de administrador.
Opción 2: Docker Compose (recomendado)
Paso 1: Descargar docker-compose.yml
curl https://raw.githubusercontent.com/docusealco/docuseal/master/docker-compose.yml \
> docker-compose.yml
Paso 2: Iniciar DocuSeal
docker compose up -d
Paso 3: Acceder a la aplicación
Abre http://localhost:3000 y completa el registro inicial del administrador.
Docker Compose completo
Archivo docker-compose.yml con todas las opciones:
services:
docuseal:
image: docuseal/docuseal:latest
container_name: docuseal
ports:
- "3000:3000"
volumes:
- docuseal-data:/data
environment:
- DATABASE_URL=sqlite3:///data/production.sqlite3
- HOST=http://localhost:3000
- SMTP_ADDRESS=smtp.gmail.com
- SMTP_PORT=587
- SMTP_USERNAME=tu-email@gmail.com
- SMTP_PASSWORD=tu-app-password
- SMTP_DOMAIN=gmail.com
- SMTP_FROM=tu-email@gmail.com
- STORAGE=local
restart: unless-stopped
volumes:
docuseal-data:
Configurar correo saliente (SMTP)
DocuSeal necesita SMTP para enviar invitaciones de firma y notificaciones.
Gmail
SMTP_ADDRESS=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=tu-email@gmail.com
SMTP_PASSWORD=tu-app-password-aqui
SMTP_AUTHENTICATION=plain
SMTP_ENABLE_STARTTLS_AUTO=true
Office 365
SMTP_ADDRESS=smtp.office365.com
SMTP_PORT=587
SMTP_USERNAME=tu-email@empresa.com
SMTP_PASSWORD=tu-contraseña
SMTP_AUTHENTICATION=plain
SMTP_ENABLE_STARTTLS_AUTO=true
Sendgrid
SMTP_ADDRESS=smtp.sendgrid.net
SMTP_PORT=587
SMTP_USERNAME=apikey
SMTP_PASSWORD=tu-api-key-sendgrid
Usar PostgreSQL (opcional)
Por defecto DocuSeal usa SQLite. Para producción, recomendamos PostgreSQL:
services:
postgres:
image: postgres:16
container_name: docuseal-postgres
environment:
- POSTGRES_DB=docuseal
- POSTGRES_USER=docuseal
- POSTGRES_PASSWORD=contraseña-segura
volumes:
- postgres-data:/var/lib/postgresql/data
restart: unless-stopped
docuseal:
image: docuseal/docuseal:latest
depends_on:
- postgres
environment:
- DATABASE_URL=postgresql://docuseal:contraseña-segura@postgres:5432/docuseal
volumes:
postgres-data:
docuseal-data:
Almacenamiento en S3 (opcional)
Para almacenar documentos en AWS S3, MinIO u otro proveedor compatible con S3:
STORAGE=s3
AWS_ACCESS_KEY_ID=tu-access-key
AWS_SECRET_ACCESS_KEY=tu-secret-key
AWS_REGION=us-east-1
AWS_BUCKET=docuseal-documents
AWS_ENDPOINT=https://s3.us-east-1.amazonaws.com
Uso básico
Crear una plantilla
- Inicia sesión en DocuSeal
- Haz clic en New Template
- Sube un PDF o crea uno desde cero
- Arrastra campos al documento:
- Signature: Campo de firma
- Text: Campo de texto
- Date: Campo de fecha
- Checkbox: Casilla de verificación
- Initials: Iniciales
- Image: Subir imagen
- File: Adjuntar archivo
- Asigna campos a roles (ej: "Cliente", "Proveedor")
- Guarda la plantilla
Enviar documento para firma
- Selecciona una plantilla
- Haz clic en Send
- Añade firmantes (nombre y email)
- Personaliza mensaje de invitación (opcional)
- Configura orden de firma (secuencial o paralelo)
- Haz clic en Send
Los firmantes recibirán un email con un enlace único para firmar el documento.
Usar la API
DocuSeal incluye una API REST completa para automatización.
Generar API key
- Ve a Settings → API
- Haz clic en Generate API Key
- Copia y guarda la key de forma segura
Ejemplo: Enviar documento via API
curl -X POST http://localhost:3000/api/submissions \
-H "X-Auth-Token: TU-API-KEY" \
-H "Content-Type: application/json" \
-d '{
"template_id": 123,
"send_email": true,
"submitters": [
{
"email": "firmante@ejemplo.com",
"role": "Cliente"
}
]
}'
SDKs oficiales disponibles
- Ruby:
gem install docuseal
- Python:
pip install docuseal
- PHP:
composer require docuseal/docuseal-php
- JavaScript/Node: En desarrollo
Gestión y mantenimiento
Ver logs
docker compose logs -f docuseal
Reiniciar DocuSeal
docker compose restart docuseal
Detener DocuSeal
docker compose down
Actualizar a la última versión
docker compose pull
docker compose up -d
Backup de datos
docker run --rm \
-v docuseal-data:/data \
-v $(pwd):/backup \
alpine tar czf /backup/docuseal-backup-$(date +%Y%m%d).tar.gz -C /data .
Configurar HTTPS con Caddy (incluido)
DocuSeal incluye soporte integrado para HTTPS con Caddy. Edita docker-compose.yml:
services:
docuseal:
image: docuseal/docuseal:latest
ports:
- "80:80"
- "443:443"
environment:
- FORCE_SSL=true
- HOST=https://docuseal.tudominio.com
volumes:
- docuseal-data:/data
- caddy-data:/data/caddy
volumes:
docuseal-data:
caddy-data:
Requisito: Asegúrate de que tu dominio apunte a la IP del servidor. Caddy generará automáticamente certificados SSL de Let's Encrypt.
Casos de uso
- Contratos laborales: Onboarding de empleados con documentos firmados digitalmente
- Acuerdos comerciales: NDA, contratos de servicio, acuerdos de confidencialidad
- Sector inmobiliario: Contratos de arrendamiento, compraventa de propiedades
- Banca y finanzas: Apertura de cuentas, solicitudes de préstamos, KYC
- Sanidad: Consentimientos médicos, formularios de pacientes (cumple HIPAA si se configura correctamente)
- Legal: Documentos legales, poderes notariales, testamentos
- Educación: Formularios de inscripción, acuerdos de prácticas
- eCommerce: Términos y condiciones, acuerdos de suscripción
Sígueme en mis redes sociales
Comentarios
Publicar un comentario