---
title: "Deploy DocuSeal"
description: "Open-source document signing with Postgres and persistent file storage"
category: "Other"
url: https://railway.com/deploy/docuseal-2
---

# Deploy DocuSeal

Open-source document signing with Postgres and persistent file storage

**[Deploy DocuSeal on Railway](https://railway.com/template/docuseal-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/docuseal-2/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### DocuSeal https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/docuseal.png

- **Source:** https://github.com/aalfath/docuseal-railway-template-2
- **Health check:** /up
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# 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_PASSWORD` and `SMTP_FROM` for email invitations
* `S3_ATTACHMENTS_BUCKET` plus AWS credentials, to keep documents in S3 instead of the volume
* `APP_URL`, for example `https://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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/docuseal-2
