
Deploy SignuDoc
Self-hosted, open-source DocuSign alternative for sending and signing PDFs
signudoc
Just deployed
/data
Just deployed
/var/lib/postgresql/data
Deploy and Host SignuDoc on Railway
SignuDoc is an open-source, self-hosted alternative to DocuSign. You upload PDFs, place fields for signers, send signing invitations by email, and track every envelope through to completion. Finished documents are sealed with a PAdES signature, so any later change shows. Each one comes with a hash-chained audit trail and a certificate of completion.
About Hosting SignuDoc
SignuDoc is a Next.js app that runs on Node.js 24, with Postgres as its database. This template deploys the app from GitHub alongside a Postgres service. It attaches a volume for stored PDFs and generates the auth secret and a setup token automatically. Database migrations run before each deploy. Email is sent through Resend, so you'll need a Resend API key. Once the deploy finishes, follow the first-time setup steps below to claim your install.
First-Time Setup (Do This Right After Deploying)
A new SignuDoc install belongs to whoever sets it up first. This template protects yours with a secret setup token, and you'll need that token to get in.
- In Railway, open the SignuDoc service, go to the Variables tab, and copy the value of
SETUP_TOKEN. - Open your SignuDoc URL. It takes you to the
/setuppage. - Paste the setup token when asked.
- Name your organization, enter a support email address, and create your account. That account becomes the administrator.
- Under Settings → Organization, enter a "Send email from" address at your domain, then add the DNS records SignuDoc shows. Email from that address won't be delivered until the domain is verified.
Common Use Cases
- Sending contracts, NDAs and offer letters for e-signature without per-seat fees
- Keeping signed documents and audit trails on infrastructure you control, for privacy or compliance
- Running regulated signing workflows with FDA 21 CFR Part 11 mode, SSO and enforced two-step sign-in
Dependencies for SignuDoc Hosting
- PostgreSQL (included in this template)
- A Resend account and API key for sending email
Implementation Details
Keep BETTER_AUTH_SECRET the same after setup. It also encrypts the key that seals PDFs and the two-step sign-in codes. If it changes, everyone is signed out and two-step sign-in stops working.
PDFs are stored on the volume mounted at /data, so run the service as a single replica.
SignuDoc has a daily cleanup job that removes stale drafts and sends due reminders. Have a scheduler call it once a day:
curl -X POST https:///api/internal/retention
Why Deploy SignuDoc 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 SignuDoc 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
signudoc
NYLLON-SOFTWARE/signudocRESEND_API_KEY
API key from resend.com, used to send signing invitations and completed documents. Required for email.
