How do I deploy Notifuse on Railway?

You can deploy Notifuse on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: notifuse-4f4fb161, or click "Get template help" for this template for more assistance.

Deploy and Host Notifuse on Railway

Notifuse is an open-source, self-hosted email marketing and transactional email platform. It's a modern alternative to Mailchimp, Brevo, or Listmonk with a visual drag-and-drop email builder (MJML), campaign management, A/B testing, subscriber segmentation, multi-provider support (Amazon SES, Mailgun, Postmark, SendGrid, SparkPost, Mailjet, SMTP), and a powerful transactional API—all without per-email pricing.

About Hosting Notifuse

Notifuse is built with Go and React and requires a PostgreSQL database. On first launch, an interactive Setup Wizard guides you through configuration—setting up your root administrator email, API endpoint, and SMTP settings. The application creates a separate database for each workspace to ensure data isolation. You'll need PostgreSQL with root credentials (Notifuse creates the databases automatically), and an SMTP server for system emails like password resets and invitations. The only required environment variable is SECRET_KEY for encryption; all other settings can be configured through the Setup Wizard or set as environment variables.

Common Use Cases

Send newsletters and marketing campaigns with a visual MJML email builder, A/B testing, and detailed open/click analytics
Power transactional emails for your application via REST API with multi-provider support and automatic failover
Replace expensive email marketing SaaS with a self-hosted solution that has no per-email fees and keeps subscriber data on your infrastructure

Dependencies for Notifuse Hosting

PostgreSQL 17+ (with root credentials for automatic database creation per workspace)

Deployment Dependencies

Implementation Details

Required environment variables:

# PostgreSQL connection (root credentials required)
DB_HOST=your-postgres-host
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=your_password

# Encryption key (generate with: openssl rand -base64 32)
# IMPORTANT: Never change after initial setup - it encrypts all secrets
SECRET_KEY=your_generated_secret_key

Optional environment variables (can also be set via Setup Wizard):

# Root admin and API endpoint
ROOT_EMAIL=admin@yourcompany.com
API_ENDPOINT=https://your-notifuse-instance.railway.app

# SMTP for system emails
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=your_username
SMTP_PASSWORD=your_password
SMTP_FROM_EMAIL=noreply@yourcompany.com

Notifuse exposes port 8080 for the web console and API. For the full list of environment variables, see the installation documentation.

Why Deploy Notifuse 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 Notifuse 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.