DEV Community

Cover image for How to Self-Host Docmost on Railway — The Free Alternative to Notion ($16/mo)
Amritasha Agrawal
Amritasha Agrawal

Posted on

How to Self-Host Docmost on Railway — The Free Alternative to Notion ($16/mo)

How to Self-Host Docmost on Railway — The Free Alternative to Notion ($16/mo)

If you're building a product or running a team, you need somewhere to put your docs. Notion is the obvious choice. Then you check the pricing — $16/mo per user — and do the math for a 10-person team.

That's $160/mo just to write things down.

Docmost is the open-source alternative. Real-time collaborative editing, nested pages, rich text, comments, permissions — everything you actually use in Notion. Self-hosted on Railway for around $5/mo total, regardless of how many users you have.

What is Docmost?

Docmost is an open-source collaborative wiki and documentation platform. Think Notion or Confluence, but you own the data and pay for infrastructure only.

It supports real-time collaborative editing, meaning multiple people can write in the same document at the same time — no conflicts, no refresh needed. You get nested pages, rich text formatting, image uploads, comments, workspaces, and role-based permissions.

It's built for teams who want a clean knowledge base without paying per seat.

Pricing Comparison

Platform Price
Notion $16/mo per user
Confluence $6.05/mo per user
Coda $12/mo per user
Outline $10/mo per user
Docmost on Railway ~$5/mo total

A 10-person team on Notion costs $160/mo. The same team on self-hosted Docmost costs $5/mo.

What You Get

  • Real-time collaborative editing — multiple people, one document, no conflicts
  • Nested pages — organize docs in a hierarchy that makes sense
  • Rich text editor — headings, tables, code blocks, images, embeds
  • Comments and mentions — discuss directly inside documents
  • Workspaces — separate spaces for different teams or projects
  • Role-based permissions — control who can read, write, or manage
  • Full-text search — find anything across all your docs instantly

Deploy in 5 Minutes

Railway handles the infrastructure. PostgreSQL and Redis are provisioned automatically. The service is pre-exposed — no networking setup needed.

Step 1 — Click Deploy

https://railway.com/deploy/docmost-1?referralCode=Ib5Dqy&utm_medium=integration&utm_source=template&utm_campaign=generic

This sets up Docmost, PostgreSQL, and Redis automatically.

Step 2 — Set one variable

Generate a secret key by running this in your terminal:

openssl rand -hex 64
Enter fullscreen mode Exit fullscreen mode

Set APP_SECRET to the output. Everything else including your app URL is pre-configured.

Step 3 — Wait about 2 minutes

Railway builds the container and runs database migrations on first boot. You'll see the deployment go green in the dashboard.

Step 4 — Create your admin account

Open your Railway domain. Docmost walks you through account setup in about 30 seconds.

Step 5 — Create your first workspace

Add your team members, create pages, and start writing. The editor works like Notion — just start typing.

Optional: File Storage

By default files are stored locally. For production use, switch to S3:

STORAGE_DRIVER=s3
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret
AWS_REGION=us-east-1
AWS_BUCKET=your-bucket
Enter fullscreen mode Exit fullscreen mode

Works with AWS S3, Cloudflare R2, or any S3-compatible provider.

When to Move On

Docmost works well for most teams. If you need advanced features:

  • Notion — databases, templates, and a huge ecosystem of integrations
  • Confluence — deep Jira integration for engineering orgs
  • Outline — another solid open-source option with a polished UI

Most teams won't hit Docmost's limits. It covers 95% of what people actually use Notion for.

Bottom Line

If your team needs a shared knowledge base and you're paying per seat, self-hosting is worth considering. Docmost gives you real-time collaboration, nested docs, and team permissions without the $160/mo bill.

Deploy it here: https://railway.com/deploy/docmost-1?referralCode=Ib5Dqy&utm_medium=integration&utm_source=template&utm_campaign=generic

Amritasha builds open-source Railway templates for small businesses — deploy production-ready tools without the enterprise pricing. Connect on LinkedIn (https://www.linkedin.com/in/amritasha/) or reach out at amritasha.ag@gmail.com

Top comments (0)