Documenso

Key Features

• PDF document upload and signature field positioning with drag-and-drop interface
• Email-based signing workflows with automatic notifications to multiple signers
• Legally compliant electronic signatures with audit trails and timestamping
• Multi-party document signing with sequential or parallel signing order support
• Document status tracking and completion notifications for all parties
• PostgreSQL-backed document storage with full ACID compliance for signature integrity
• NextAuth.js authentication system supporting multiple identity providers
• Mobile-responsive signing interface for signatures on any device

Common Use Cases

• 1Legal firms processing contracts, NDAs, and client agreements with secure signature workflows
• 2HR departments handling employment contracts, onboarding documents, and policy acknowledgments
• 3Real estate agencies managing purchase agreements, lease contracts, and disclosure documents
• 4Small to medium businesses replacing DocuSign to reduce subscription costs and maintain data control
• 5Healthcare organizations requiring HIPAA-compliant document signing for patient forms and consent documents
• 6Educational institutions processing enrollment forms, permission slips, and administrative documents
• 7Financial services firms handling loan documents, account openings, and compliance paperwork

Prerequisites

• Docker and Docker Compose installed with at least 2GB available RAM for optimal performance
• Port 3000 available on the host system for web interface access
• Environment file (.env) configured with secure NEXTAUTH_SECRET and DB_PASSWORD values
• OpenSSL available for generating cryptographically secure authentication secrets
• Basic understanding of document signing workflows and legal requirements for electronic signatures
• Email server configuration or SMTP credentials for sending signing invitations to document recipients

docker-compose.yml

1services: 
2  documenso: 
3    image: documenso/documenso:latest
4    container_name: documenso
5    restart: unless-stopped
6    ports: 
7      - "3000:3000"
8    environment: 
9      NEXTAUTH_URL: http://localhost:3000
10      NEXTAUTH_SECRET: ${NEXTAUTH_SECRET}
11      NEXT_PRIVATE_DATABASE_URL: postgresql://documenso:${DB_PASSWORD}@db:5432/documenso
12    depends_on: 
13      - db
14
15  db: 
16    image: postgres:15-alpine
17    container_name: documenso-db
18    restart: unless-stopped
19    environment: 
20      POSTGRES_USER: documenso
21      POSTGRES_PASSWORD: ${DB_PASSWORD}
22      POSTGRES_DB: documenso
23    volumes: 
24      - documenso_db:/var/lib/postgresql/data
25
26volumes: 
27  documenso_db: 

.env Template

1DB_PASSWORD=changeme
2NEXTAUTH_SECRET=generate-32-char-secret

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

documenso:
  image: documenso/documenso:latest
  container_name: documenso
  restart: unless-stopped
  ports:
    - "3000:3000"
  environment:
    NEXTAUTH_URL: http://localhost:3000
    NEXTAUTH_SECRET: ${NEXTAUTH_SECRET}
    NEXT_PRIVATE_DATABASE_URL: postgresql://documenso:${DB_PASSWORD}@db:5432/documenso
  depends_on:
    - db

db:
  image: postgres:15-alpine
  container_name: documenso-db
  restart: unless-stopped
  environment:
    POSTGRES_USER: documenso
    POSTGRES_PASSWORD: ${DB_PASSWORD}
    POSTGRES_DB: documenso
  volumes:
    - documenso_db:/var/lib/postgresql/data

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  documenso:
5    image: documenso/documenso:latest
6    container_name: documenso
7    restart: unless-stopped
8    ports:
9      - "3000:3000"
10    environment:
11      NEXTAUTH_URL: http://localhost:3000
12      NEXTAUTH_SECRET: ${NEXTAUTH_SECRET}
13      NEXT_PRIVATE_DATABASE_URL: postgresql://documenso:${DB_PASSWORD}@db:5432/documenso
14    depends_on:
15      - db
16
17  db:
18    image: postgres:15-alpine
19    container_name: documenso-db
20    restart: unless-stopped
21    environment:
22      POSTGRES_USER: documenso
23      POSTGRES_PASSWORD: ${DB_PASSWORD}
24      POSTGRES_DB: documenso
25    volumes:
26      - documenso_db:/var/lib/postgresql/data
27
28volumes:
29  documenso_db:
30EOF
31
32# 2. Create the .env file
33cat > .env << 'EOF'
34DB_PASSWORD=changeme
35NEXTAUTH_SECRET=generate-32-char-secret
36EOF
37
38# 3. Start the services
39docker compose up -d
40
41# 4. View logs
42docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/documenso/run | bash

Troubleshooting