Deploy LibreChat

Deploy and Host LibreChat on Railway

LibreChat is the open-source AI chat platform with 46,000+ GitHub stars: one ChatGPT-style interface for OpenAI, Anthropic, Google, OpenRouter and many more models, with agents, file search and conversation history. ChatGPT Business and Claude Team cost $20–25 per seat per month — self-host LibreChat on Railway for ~$12–20/month plus the API usage you actually pay for, and keep every conversation in your own database.

What This Template Deploys

Five services on Railway's private network. Only LibreChat is public; databases, search and the RAG API are internal.

About Hosting LibreChat

A complete LibreChat install needs the app, MongoDB, Meilisearch for search, a RAG API and a vector database for file chat, plus secrets in exact formats: CREDS_KEY must be 64 hex characters and CREDS_IV 32. Getting all of that right by hand takes Docker Compose, a reverse proxy and careful key generation.

On Railway, all five services start together, LibreChat gets an HTTPS domain, DOMAIN_CLIENT and DOMAIN_SERVER point at it automatically, and every secret is generated in the correct format. Registration is closed by default, and an admin account is created from ADMIN_EMAIL on first start.

File search needs an OpenRouter key. The RAG API creates embeddings through OpenRouter using OPENROUTER_KEY from the LibreChat service. Leave it empty and chat still works with per-user keys, but uploading files for search won't.

Typical cost: ~$12–20/month on Railway for the stack, plus the AI API usage you choose. ChatGPT Business is $20 per seat per month (annual; $25 monthly) and Claude Team $20–25 per standard seat — a 10-person team pays $200–250/month before anyone sends a message.

Deploy LibreChat in Under 10 Minutes

1. Set ADMIN_EMAIL when deploying — it's the only required input.
2. Click Deploy on Railway — LibreChat builds and the databases start (~5–8 minutes).
3. Copy ADMIN_PASSWORD from the LibreChat service's variables and sign in at the public URL.
4. Add an OPENROUTER_KEY (or your own OpenAI, Anthropic or Google keys) to enable models for everyone, or let each user paste their own key in the UI.
5. Set ALLOW_REGISTRATION to true while your team signs up, then back to false.

No Docker Compose. No hand-made encryption keys. No reverse proxy.

Common Use Cases

• Self-hosted ChatGPT alternative — "open source chatgpt alternative" with no per-seat pricing
• One interface for every model — switch between GPT, Claude, Gemini and OpenRouter models mid-conversation
• Team AI workspace — shared agents and presets on one private instance
• Chat with your documents — upload PDFs and files and ask questions with RAG
• Private AI for sensitive data — conversations stay in your own MongoDB, not a vendor's app
• Pairs with n8n — connect LibreChat agents to your automations through MCP and APIs

Configuration

Keep CREDS_KEY and CREDS_IV safe. LibreChat doesn't re-encrypt stored keys when they change, so replacing them makes every saved user API key unreadable.

LibreChat vs. Alternatives

Dependencies for LibreChat Hosting

• Railway account — Hobby ($5/month) runs it; plan for ~1.2–1.5 GB RAM across five services.
• API keys for the models you want (OpenRouter, OpenAI, Anthropic or Google), either shared or per user.
• An OpenRouter key if you want file search (RAG).

Deployment Dependencies

• LibreChat GitHub — source and releases
• LibreChat Docs — configuration and providers
• Meilisearch — conversation search
• Railway Volumes Documentation — persistence

Implementation Details

LibreChat builds from the template's GitHub source and talks to mongo:8.0, getmeili/meilisearch:v1.35.1, the librechat-rag-api-dev-lite RAG API and pgvector/pgvector:pg17 over the private network. MongoDB binds with IPv6 for Railway's internal network, and uploads live on the /data volume.

The values to protect are CREDS_KEY and CREDS_IV, which encrypt user API keys, and JWT_SECRET, which the RAG API also uses. DOMAIN_CLIENT and DOMAIN_SERVER must match the public URL — update both together for a custom domain.

Frequently Asked Questions

What is LibreChat and why self-host it? LibreChat is an open-source ChatGPT-style interface that works with many AI providers in one place. Self-hosting removes per-seat fees, lets you pick any model, and keeps conversations in your own database.

How much does self-hosting LibreChat cost compared to ChatGPT Business? About $12–20/month in Railway usage plus pay-as-you-go API costs. ChatGPT Business is $20 per seat per month billed annually ($25 monthly), so 10 users cost $200–250/month on seats alone.

Why isn't file upload or file search working in LibreChat? The RAG API needs OPENROUTER_KEY on the LibreChat service to create embeddings. Add the key and redeploy rag-api; until then, chat works but file search doesn't.

Do I lose conversations when I redeploy? No. Conversations, users and agents live in MongoDB on a persistent volume, file embeddings in pgvector, and uploads on LibreChat's /data volume. The Meilisearch index has no volume and is rebuilt from MongoDB after a redeploy.

Can I use Claude, Gemini or local models with LibreChat? Yes. LibreChat supports OpenAI, Anthropic, Google, AWS Bedrock, OpenRouter, Groq, Mistral, DeepSeek and more, plus any OpenAI-compatible endpoint through custom endpoints.

How do users get accounts if registration is closed? The admin account is created from ADMIN_EMAIL on first start. To add your team, set ALLOW_REGISTRATION to true, let them sign up, then set it back to false.

Why Deploy and Host LibreChat 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 LibreChat on Railway, you get a private, multi-model AI chat for your team — agents, file search and conversation search — for a flat hosting cost plus only the API usage you choose.