Deploy and Host Pneumatic on Railway

Pneumatic is an open-source workflow management system that empowers teams to create, run, and optimize business processes collaboratively. It features reusable workflow templates, parallel multi-workflow execution, individual task buckets for staff, and automated stage tracking with real-time handoffs between teams.

About Hosting Pneumatic

Deploying Pneumatic involves running a multi-service architecture composed of a Django/Gunicorn backend (with ASGI via Uvicorn), a Next.js frontend served through PM2, Celery workers and Celery Beat for async task processing and scheduled jobs. The stack requires PostgreSQL for data persistence, Redis for caching, sessions, and WebSocket channels, and RabbitMQ as the Celery message broker. Railway simplifies this by managing each service as a separate component with shared networking and environment variables, eliminating the need to manually configure Docker Compose, SSL, and inter-service communication.

Common Use Cases

Business Process Automation: Design reusable workflow templates for recurring processes like employee onboarding, customer support escalation, or content approval pipelines.
Cross-Team Task Coordination: Assign multi-step workflows that automatically hand off tasks between departments, with real-time tracking of each stage's progress.
SaaS Integration Hub: Connect Pneumatic to external tools via its public REST API or Zapier integration, automating data flow between CRM, HR, and project management systems.

Dependencies for Pneumatic Hosting

PostgreSQL 15 — primary relational database for all application data
Redis 6.2 — used for auth tokens, caching, Django Channels (WebSockets), and session storage
RabbitMQ 3.13 — message broker for Celery async task queue

Deployment Dependencies

Implementation Details

The application runs 7 interconnected services. Key environment variables to configure:

# Core URLs (must match your Railway-provided domain)
BACKEND_URL=https://your-railway-domain.up.railway.app
FRONTEND_URL=https://your-railway-domain.up.railway.app
WSS_URL=wss://your-railway-domain.up.railway.app

# Security (change these from defaults!)
DJANGO_SECRET_KEY=
POSTGRES_PASSWORD=
REDIS_PASSWORD=
RABBITMQ_DEFAULT_PASS=

# Optional integrations
AI=no                # Enable OpenAI-powered features
EMAIL=no             # Enable email notifications (SMTP or Customer.io)
STORAGE=no           # Enable Google Cloud Storage for file attachments
SSO_AUTH=no           # Enable SSO via Okta or Auth0

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