documenso

Official

Overview

Documenso — open-source e-signature platform (self-hosted DocuSign alternative). Exposes a web UI on the configured port (default 3000). Requires PostgreSQL and SMTP settings. If you use a reverse proxy, set NEXT_PUBLIC_WEBAPP_URL and NEXTAUTH_URL to your public HTTPS URL (no trailing slash).

Runtime arguments

Web UI: http://[IP]:[PORT:3000]/
Network: bridge
Shell: sh
Privileged: false
Extra Params: --restart unless-stopped

Template configuration

HTTP PortPorttcp

Web UI / API port (container 3000 → host)

Target: 3000
Default: 3000
Value: 3000

NEXT_PUBLIC_WEBAPP_URLVariable

Public base URL used in links/emails (no trailing slash)

Default: https://documenso.example.com

NEXTAUTH_URLVariable

Canonical public URL for Auth.js/NextAuth (no trailing slash)

AUTH_TRUST_HOSTVariable

Trust reverse proxy headers for Auth.js (true when behind NPM)

Default: true
Value: true

NEXT_PUBLIC_DISABLE_SIGNUPVariable

Disable self-service /signup (true = staff invite/guest signing only)

Default: true
Value: false

NEXTAUTH_SECRETVariable

Long random secret for Auth.js/NextAuth (≥32 chars)

NEXT_PRIVATE_ENCRYPTION_KEYVariable

Primary encryption key for stored secrets (≥32 chars)

NEXT_PRIVATE_DATABASE_URLVariable

Primary DB URL (with pooling)

Default: postgresql://user:pass@host:5432/db?sslmode=prefer
Value: postgresql://user:pass@host:5432/db?sslmode=prefer

NEXT_PRIVATE_DIRECT_DATABASE_URLVariable

Direct DB URL (no pooling; migrations/long queries)

Default: postgresql://user:pass@host:5432/db?sslmode=prefer
Value: postgresql://user:pass@host:5432/db?sslmode=prefer

NEXT_PRIVATE_SMTP_TRANSPORTVariable

Email transport (smtp-auth | smtp-api | resend | mailchannels)

Default: smtp-auth
Value: smtp-auth

NEXT_PRIVATE_SMTP_HOSTVariable

SMTP host (smtp-auth)

Default: smtp.example.com
Value: smtp.example.com

NEXT_PRIVATE_SMTP_PORTVariable

SMTP port (smtp-auth; 587 STARTTLS or 465 SSL/TLS)

Default: 587
Value: 587

NEXT_PRIVATE_SMTP_USERNAMEVariable

SMTP username (smtp-auth)

NEXT_PRIVATE_SMTP_PASSWORDVariable

SMTP password/app password (smtp-auth)

NEXT_PRIVATE_SMTP_FROM_NAMEVariable

Email 'From' display name

Default: Documenso
Value: Documenso

NEXT_PRIVATE_SMTP_FROM_ADDRESSVariable

Email 'From' address

Default: no-reply@example.com
Value: no-reply@example.com

Signing Cert (.p12) PathPathro

Host path to PKCS#12 certificate

Target: /opt/documenso/signing
Default: /mnt/user/appdata/documenso/cert.p12
Value: /mnt/user/appdata/documenso/cert.p12

NEXT_PRIVATE_SIGNING_TRANSPORTVariable

Signing transport (local or cloud provider)

Default: local
Value: local

NEXT_PRIVATE_ENCRYPTION_SECONDARY_KEYVariable

Secondary encryption key (for key rotation; optional)

NEXT_PRIVATE_SMTP_SECUREVariable

true = SSL/TLS (465), false = STARTTLS (587)

Default: false
Value: false

NEXT_PRIVATE_SIGNING_PASSPHRASEVariable

Passphrase for the .p12 signing certificate (if set)

NEXT_PRIVATE_SIGNING_LOCAL_FILE_PATHVariable

Override signing cert path inside container (default /opt/documenso/cert.p12)

Default: /opt/documenso/cert.p12

NEXT_PUBLIC_UPLOAD_TRANSPORTVariable

Upload backend: database or s3

Default: database
Value: database

NEXT_PRIVATE_UPLOAD_ENDPOINTVariable

S3 endpoint URL (if using S3/compatible)

NEXT_PRIVATE_UPLOAD_FORCE_PATH_STYLEVariable

Force path-style S3 URLs (true/false)

Default: false
Value: false

NEXT_PRIVATE_UPLOAD_REGIONVariable

S3 region

Default: us-east-1
Value: us-east-1

NEXT_PRIVATE_UPLOAD_BUCKETVariable

S3 bucket name

NEXT_PRIVATE_UPLOAD_ACCESS_KEY_IDVariable

S3 access key ID

NEXT_PRIVATE_UPLOAD_SECRET_ACCESS_KEYVariable

S3 secret access key

PORTVariable

Internal listening port (normally 3000; don’t change)

Default: 3000
Value: 3000

NEXT_PUBLIC_DOCUMENT_SIZE_UPLOAD_LIMITVariable

Max document upload size shown in UI (MB)

Default: 25
Value: 25

Links

Template Support Registry Project

Details

Repository

ghcr.io/documenso/documenso:latest

Registry

https://github.com/documenso/documenso/pkgs/container/documenso

Last Updated2026-05-13

First Seen2025-10-02

Run Documenso on Unraid.

Documenso is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS