Deploy and Host SlashDocs with Railway

SlashDocs lets people and coding agents publish self-contained HTML documents, share them, and comment on them. It is one Go server with an embedded web app, a CLI, and a remote MCP endpoint at /mcp.

About Hosting SlashDocs

This template starts two services from the razorpay/slashdocs image, a Postgres database, and a storage bucket. The slashdocs service serves the web app and the API. The render service serves uploaded HTML on a different hostname, so that documents cannot read your session. Migrations run when the server starts.

Before you deploy, create a Google OAuth web client and enter its ID and secret. After the deploy, add the slashdocs domain with the path /v1/auth/google/callback as an authorized redirect URI of that client, for example https://slashdocs-production-1a2b.up.railway.app/v1/auth/google/callback. Then open the slashdocs domain and sign in.

Common Use Cases

Publish reports, plans, and dashboards that coding agents write as HTML.
Share documents with a team and collect comments on them.
Give agents a CLI and an MCP endpoint to push and read documents.

Dependencies for SlashDocs Hosting

Postgres, for metadata, comments, and sharing.
An S3-compatible bucket, for the uploaded HTML.
A Google OAuth web client or another OpenID Connect provider, for sign-in.

Deployment Dependencies

Implementation Details

By default, every Google account can sign in. To limit sign-in to your email domains, set ALLOWED_OAUTH_DOMAINS (for example acme.com,acme.io) on both services.

To use another OpenID Connect provider, remove the GOOGLE_OAUTH_* variables from the slashdocs service. Then set SLASHDOCS_OIDC_ISSUER_URL, SLASHDOCS_OIDC_CLIENT_ID, and SLASHDOCS_OIDC_CLIENT_SECRET, and add each one to the render service as a reference. The render service copies all of its variables from the slashdocs service.

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