explaingit

docusealco/docuseal

Analysis updated 2026-06-24

16,503RubyAudience · developerComplexity · 3/5LicenseSetup · easy

TLDR

Open-source DocuSign alternative for sending and signing PDFs online. Self-hostable with a drag-and-drop form builder, signer workflow, and API for integration.

Mindmap

mindmap
  root((docuseal))
    Inputs
      PDF upload
      Form field positions
      Signer emails
    Outputs
      Signed PDF with stamp
      Webhook events
      Audit trail
    Use Cases
      Send contracts for e-signature
      Self-host a DocuSign replacement
      Embed signing in your own app
    Tech Stack
      Ruby
      Rails
      PostgreSQL
      Docker
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Send a contract PDF to a client to sign from any device

USE CASE 2

Self-host a DocuSign replacement and keep documents on your own server

USE CASE 3

Embed a signing flow into your SaaS using the API and webhooks

USE CASE 4

Build templates with drag and drop fields for recurring agreements

What is it built with?

RubyRailsPostgreSQLDocker

How does it compare?

docusealco/docusealpostalserver/postalspree/spree
Stars16,50316,51115,421
LanguageRubyRubyRuby
Setup difficultyeasyhardmoderate
Complexity3/54/54/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

One Docker command brings it up, SMTP credentials needed before signers can be emailed.

Free to use and self-host, but if you modify and offer it as a network service you must release your changes under the same license.

In plain English

DocuSeal is an open-source alternative to DocuSign, a self-hostable platform for creating, filling, and signing digital documents. If your business needs to send contracts, agreements, or forms for people to sign electronically, DocuSeal lets you do that without paying for a commercial e-signature service and while keeping your document data on your own servers. The workflow is straightforward: you upload a PDF, use a drag-and-drop form builder to place fields (signature, date, text, checkbox, file upload, etc.) where you need them, then send the document to one or more people for them to fill and sign online, from any device, including mobile. Once signed, the PDF is stamped with a verified electronic signature. The platform also handles automated email notifications via SMTP, signature verification, user management, and can store uploaded files on local disk or cloud storage. An API and webhook system lets you integrate DocuSeal into other software products. The pro tier (paid cloud or self-hosted license) adds features like branded/white-label setup, user roles, conditional form fields, bulk send via spreadsheet import, SMS identity verification, single sign-on, and the ability to embed the signing or form-builder interface directly into other web apps. Deployment is straightforward: a single Docker command starts it in minutes, using a local database by default with optional PostgreSQL or MySQL support. It can also be deployed on platforms like Heroku, Railway, DigitalOcean, and Render. Written in Ruby, licensed under AGPLv3.

Copy-paste prompts

Prompt 1
Spin up DocuSeal in Docker on a VPS and connect it to a Postgres database
Prompt 2
Show me how to upload a PDF to DocuSeal, place signature fields, and send it to two signers via the API
Prompt 3
Wire DocuSeal webhooks into my Node app so I get notified when a document is signed
Prompt 4
Configure SMTP and a custom domain so DocuSeal sends signing requests from my brand email

Frequently asked questions

What is docuseal?

Open-source DocuSign alternative for sending and signing PDFs online. Self-hostable with a drag-and-drop form builder, signer workflow, and API for integration.

What language is docuseal written in?

Mainly Ruby. The stack also includes Ruby, Rails, PostgreSQL.

What license does docuseal use?

Free to use and self-host, but if you modify and offer it as a network service you must release your changes under the same license.

How hard is docuseal to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is docuseal for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub docusealco on gitmyhub

Verify against the repo before relying on details.