Deploy DocuSeal
Open-source document signing with Postgres and persistent file storage
Just deployed
/data/docuseal
Just deployed
/var/lib/postgresql/data
Deploy and Host DocuSeal on Railway
DocuSeal is an open-source platform for creating, filling and signing digital documents. You upload a PDF, place signature, date, text and other fields in a web builder, and send it to one or more signers. Signed documents are stored with an audit trail, and DocuSeal is a self-hosted alternative to DocuSign.
About Hosting DocuSeal
DocuSeal is a Ruby on Rails app with a PostgreSQL database. This template builds it from a small GitHub repo that pins the official docuseal/docuseal image (3.3.6, by digest), and adds Railway Postgres. Uploaded documents, signed copies and the app's built-in Redis data are kept on a volume at /data/docuseal. SECRET_KEY_BASE is generated at deploy, and the database is reached over Railway's private network. There is no default login: the first person to open the app creates the admin account, so open your Railway URL right after the deploy finishes. To send signing requests by email, add your SMTP settings later.
Common Use Cases
- Sending contracts, NDAs and offer letters for signature
- Collecting filled-in forms such as onboarding paperwork or consent forms
- Automating signing workflows from your own app through the DocuSeal API and webhooks
Dependencies for DocuSeal Hosting
- PostgreSQL (Railway Postgres, included)
- A volume for documents and attachments (included)
Deployment Dependencies
- DocuSeal source and docs: https://github.com/docusealco/docuseal
- DocuSeal 3.3.6 release: https://github.com/docusealco/docuseal/releases/tag/3.3.6
- Template repo: https://github.com/aalfath/docuseal-railway-template-2
Implementation Details
The app service builds from the template repo, so Railway shows you an "update available" notice when a newer tested DocuSeal version is merged there. The repo's CHANGELOG.md lists what each update changes.
Optional settings you can add as service variables after deploying:
SMTP_ADDRESS,SMTP_PORT,SMTP_USERNAME,SMTP_PASSWORDandSMTP_FROMfor email invitationsS3_ATTACHMENTS_BUCKETplus AWS credentials, to keep documents in S3 instead of the volumeAPP_URL, for examplehttps://sign.YOUR-DOMAIN, if you add a custom domain (or change the app URL in DocuSeal's settings)
Don't change SECRET_KEY_BASE after the first boot: DocuSeal uses it to encrypt stored settings.
Why Deploy DocuSeal on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying DocuSeal on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
