DocuSeal 3 Document Signing (Postgres)
DocuSeal 3.3.6 is an open-source platform for fillable PDF forms and electronic signatures. This template deploys the official image with Postgres and a document volume, and creates the admin account privately before the instance goes public.
What you get
- DocuSeal 3.3.6, official image pinned by digest, running web server, jobs and an embedded Redis in one service
- PostgreSQL 18 for accounts, templates, submissions and audit events
- A Railway volume at /data/docuseal for uploaded and signed documents
- Admin account created at first start with a generated password, before the public port opens
- Health check at /up
Good for
- Sending contracts, NDAs and offer letters for signature without per-envelope fees
- Turning existing PDFs into reusable templates with signature, date, text and checkbox fields
- Embedding signing links in your own product with webhooks or the API
- Keeping signed documents and audit logs on infrastructure you control
Cost
Measured on Railway: DocuSeal about 180 to 200 MiB RAM idle and Postgres about 80 to 110 MiB, near-zero CPU, so roughly $3 to $4 per month idle plus volume storage. Large PDFs may need more memory.
Services in this template
- Postgres · image
ghcr.io/railwayapp-templates/postgres-ssl:18@sha256:4fc833b43d2aaf6ecc9b18615f5533602b723a32d0e2efe2dae8ca0f7217c863 - DocuSeal · from
baranberkay96/docuseal-railway
Questions people ask
How do I log in?
Open your domain and sign in with DOCUSEAL_ADMIN_EMAIL (default admin@example.com) and DOCUSEAL_ADMIN_PASSWORD from the service's Variables tab. There is no shared default password. Change the e-mail under Profile and consider turning on two-factor authentication.
Can DocuSeal send e-mail?
Only over SMTP. Configure it under Settings > Email or with the SMTP_* variables. Railway allows outbound SMTP only on Pro plans, so on other plans copy the signing link and send it yourself.
Are documents kept across redeploys?
Yes. Signed documents are on the DocuSeal volume and their records in Postgres. Enable Railway volume backups for both volumes.
What licence applies?
AGPL-3.0 with an additional term that keeps the DocuSeal attribution in the user interface. The image runs unmodified. Pro features such as white-label, user roles and SMS verification are not part of the open-source edition.
How do I upgrade?
Change the FROM line (tag and digest) in services/docuseal/Dockerfile, back up, and redeploy. DocuSeal migrates the database on start.
Full template README
Deploy and Host DocuSeal with Railway
DocuSeal is an open-source platform for creating fillable PDF forms and collecting electronic signatures. This community template runs the official DocuSeal 3 image with PostgreSQL, a persistent volume for documents, a pinned version and an admin account created for you before the instance goes public.
About Hosting DocuSeal
DocuSeal is a Ruby on Rails app that runs its web server, background jobs and a small Redis in one container. It needs a database, a stable SECRET_KEY_BASE (it encrypts settings and the signing certificate) and persistent storage for uploaded and signed documents. A fresh DocuSeal shows a setup page where the first visitor creates the admin account; on a public URL anyone could get there first. This template completes that setup on a private loopback port during the first start, with a generated password, and only then opens the public port. Documents stay on a Railway volume across redeploys.
Common Use Cases
- Sending contracts, NDAs, offer letters and order forms for signature without per-envelope fees
- Turning existing PDFs into reusable templates with signature, date, text and checkbox fields
- Embedding signing links in your own product or portal and receiving results by webhook or API
- Keeping signed documents and audit logs on infrastructure you control
Dependencies for DocuSeal Hosting
- DocuSeal 3.3.6, official image
docuseal/docuseal, pinned by digest (AGPL-3.0) - PostgreSQL 18 (Railway Postgres, pinned by digest)
- A Railway volume for documents (
/data/docuseal) - Optional: an SMTP server for e-mail (see below)
Deployment Dependencies
- DocuSeal: https://www.docuseal.com
- Source, releases and licence: https://github.com/docusealco/docuseal
- Documentation and API: https://www.docuseal.com/docs
- Self-hosting guide: https://www.docuseal.com/install
Implementation Details
| Service | Role | Public | Storage |
|---|---|---|---|
| DocuSeal | Web app, API, background jobs, embedded Redis; health /up |
Yes, port 3000 | Volume /data/docuseal (documents) |
| Postgres | Accounts, templates, submissions, audit events | No | Volume |
First login
- Wait until the DocuSeal deployment is active. The very first start takes a little longer because the admin account is created first.
- Open
https://{your-domain}and sign in withDOCUSEAL_ADMIN_EMAIL(defaultadmin@example.com) andDOCUSEAL_ADMIN_PASSWORDfrom the DocuSeal service's Variables tab. There is no default or shared password. - Change the e-mail to your own under Profile, or set
DOCUSEAL_ADMIN_EMAILbefore the first deploy. Turning on two-factor authentication in Profile is recommended.
The setup page is never reachable from the internet: while the database has no user, DocuSeal runs only on 127.0.0.1 and the start script fills in upstream's own setup form. If that fails, the service stops instead of opening an unclaimed instance.
Send your first document: Templates > Upload a PDF, place fields, then Send or Copy the share link. Signers open the link; no account is needed on their side.
Lost admin password: set DOCUSEAL_ADMIN_PASSWORD (8-128 characters) and DOCUSEAL_RESET_ADMIN_PASSWORD=true, redeploy, log in, then set it back to false. This also unlocks an account locked after failed logins. A password that is empty or too short never blocks the deploy: the admin is created with a random password and the log explains this reset.
E-mail: DocuSeal sends signature requests, reminders and completed copies by SMTP only. Configure it under Settings > Email, or set SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD and SMTP_FROM on the DocuSeal service. Railway allows outbound SMTP only on Pro plans; on other plans copy the signing link from DocuSeal and send it yourself, or use an e-mail provider that offers SMTP on an allowed port.
Custom domain: add it in Railway, then change the app URL under Settings > Account so signing links use it.
Resources and plans: measured idle on Railway: DocuSeal ~180-200 MiB (web server, jobs and its Redis together), Postgres ~80-110 MiB, near-zero CPU; roughly $3-4 per month idle plus volume storage. Both services fit the Trial plan (1 GB per service). DocuSeal also started and kept its documents with a 0.5 GB limit (Free plan); very large PDFs or many signers at once need more memory, so raise the limit if you see restarts.
Backups: enable Railway volume backups for both the DocuSeal and the Postgres volume; signed documents live on the DocuSeal volume, their records in Postgres.
Scaling: DocuSeal keeps documents on its volume, so it runs as one replica. Raise its memory if large PDFs are slow.
Pinning and upgrades: the DocuSeal version is the FROM line in services/docuseal/Dockerfile (tag plus digest). Read the release notes, change both, back up, and redeploy; DocuSeal migrates the database on start.
Licence: DocuSeal is AGPL-3.0 with an additional term that keeps the DocuSeal attribution in the user interface. The image runs unmodified. Pro features (white-label, user roles, SMS verification and others) are not part of the open-source edition.
Why Deploy DocuSeal on Railway?
Railway gives DocuSeal an HTTPS domain, a private network to Postgres, persistent volumes with backups, generated secrets and usage-based billing. A signing service is running in minutes, and upgrades are a one-line change.
Guides for this template
View DocuSeal 3 Document Signing (Postgres) on railway.com
Similar templates
| Template | Category | DeploymentsDeploys |
|---|---|---|
| Chatwoot A customer communication platform | Other | 5,871 |
| Ubuntu-Linux Ubuntu terminal accessible via web browser | Other | 4,926 |
| Ubuntu SSH + Claude ARA TM —SSH server with root access + Claude Code pre-installed. | Other | 4,682 |
| Debian-Linux Debian terminal accessible via web browser. | Other | 2,883 |
| Code Server VS Code in the browser | Other | 2,787 |
| Kali Linux (Web Terminal) Instant Kali Linux browser terminal powered by ttyd | Other | 2,632 |