Cloud Platform Deployment

​

Supported Platforms

• Railway: Managed container platform with automatic scaling
• Zeabur: Edge-optimized deployment platform
• Sealos: Kubernetes-based cloud operating system

​

Railway Deployment

​

Quick Deploy

1

Deploy with One Click

Click the button below to deploy LibreChat to Railway:

2

Configure Environment Variables

Railway will prompt you to configure required environment variables:

# Authentication Secrets (generate with: openssl rand -hex 32)
JWT_SECRET=your-jwt-secret-here
JWT_REFRESH_SECRET=your-refresh-secret-here
CREDS_KEY=your-creds-key-here
CREDS_IV=your-creds-iv-here  # Use: openssl rand -hex 16

# Meilisearch
MEILI_MASTER_KEY=your-meili-master-key

# API Keys
OPENAI_API_KEY=your-openai-api-key
ANTHROPIC_API_KEY=your-anthropic-api-key

3

Wait for Deployment

Railway will automatically:

• Provision MongoDB, Meilisearch, and PostgreSQL
• Build and deploy the LibreChat container
• Configure networking and SSL certificates
• Provide you with a public URL

4

Access Your Instance

Once deployed, Railway provides a public URL like:

https://librechat-production-xxxx.up.railway.app

​

Features

• Automatic SSL: HTTPS certificates are provisioned automatically
• Managed Databases: MongoDB and PostgreSQL included
• Auto Scaling: Scales based on traffic
• Persistent Storage: Volumes for uploads and images
• Environment Management: Easy configuration updates
• GitHub Integration: Auto-deploy from your repository

​

Pricing

• Developer Plan: $5/month for hobby projects
• Team Plan: $20/month per seat
• Pay-as-you-go: Usage-based pricing

​

Custom Domain

1. Go to your Railway project settings
2. Navigate to Domains
3. Add your domain and configure DNS:

CNAME record: your-domain.com → your-app.up.railway.app

​

Zeabur Deployment

​

Quick Deploy

1

Deploy with Template

Click the button below to deploy LibreChat to Zeabur:

2

Select Region

Zeabur will ask you to choose a deployment region:

• Asia Pacific: Singapore, Tokyo, Hong Kong
• Europe: Frankfurt
• North America: San Francisco, New York

Choose the region closest to your users for optimal performance.

3

Configure Services

Zeabur automatically provisions:

• LibreChat application
• MongoDB database
• Meilisearch search engine
• PostgreSQL with pgvector
• RAG API service

4

Set Environment Variables

Configure required variables in the Zeabur dashboard:

# Generate secrets with: openssl rand -hex 32
JWT_SECRET=your-jwt-secret
JWT_REFRESH_SECRET=your-refresh-secret
CREDS_KEY=your-creds-key
CREDS_IV=your-creds-iv  # openssl rand -hex 16

# Meilisearch
MEILI_MASTER_KEY=your-meili-key

# AI Provider Keys
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

​

Features

• Edge Network: Global CDN for low latency
• Auto Scaling: Horizontal scaling based on load
• Managed Services: All dependencies included
• Custom Domains: Easy domain configuration
• SSL Certificates: Automatic HTTPS
• Team Collaboration: Multi-user access

​

Pricing

• Developer: $5/month (includes$5 credit)
• Team: $20/month per member
• Enterprise: Custom pricing

​

Monitoring

• Request logs and metrics
• CPU and memory usage
• Database performance
• Error tracking

​

Sealos Deployment

​

Quick Deploy

1

Deploy with Template

Click the button below to deploy LibreChat to Sealos:

2

Configure Resources

Sealos allows you to configure compute resources:

resources:
  limits:
    cpu: 2000m
    memory: 4Gi
  requests:
    cpu: 500m
    memory: 1Gi

3

Set Up Storage

Configure persistent volumes:

persistence:
  images:
    size: 10Gi
  uploads:
    size: 5Gi
  mongodb:
    size: 20Gi

4

Configure Environment

Add environment variables through the Sealos dashboard:

# Authentication
JWT_SECRET=your-jwt-secret
JWT_REFRESH_SECRET=your-refresh-secret
CREDS_KEY=your-creds-key
CREDS_IV=your-creds-iv

# Database
MONGO_URI=mongodb://mongodb:27017/LibreChat

# Search
MEILI_HOST=http://meilisearch:7700
MEILI_MASTER_KEY=your-meili-key

# AI Providers
OPENAI_API_KEY=your-key

5

Deploy Application

Click Deploy and Sealos will:

• Create Kubernetes pods for all services
• Configure internal networking
• Set up ingress for external access
• Provision persistent volumes

​

Features

• Kubernetes Native: Full K8s cluster access
• Resource Control: Fine-grained CPU/memory limits
• Auto Healing: Automatic pod recovery
• Horizontal Scaling: Manual or auto-scaling
• Persistent Storage: Multiple volume types
• Custom Networking: Advanced ingress configuration

​

Architecture on Sealos

apiVersion: v1
kind: Service
metadata:
  name: librechat
spec:
  selector:
    app: librechat
  ports:
    - port: 3080
      targetPort: 3080
  type: ClusterIP

---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: librechat
spec:
  replicas: 1
  selector:
    matchLabels:
      app: librechat
  template:
    metadata:
      labels:
        app: librechat
    spec:
      containers:
      - name: librechat
        image: registry.librechat.ai/danny-avila/librechat:latest
        ports:
        - containerPort: 3080
        env:
        - name: MONGO_URI
          value: mongodb://mongodb:27017/LibreChat

​

Pricing

• Compute: $0.045/core/hour
• Memory: $0.005/GB/hour
• Storage: $0.10/GB/month
• Traffic: $0.10/GB outbound

​

Platform Comparison

​

Best Use Cases

​

Railway

• Fastest setup time
• Generous free tier
• Great for testing

​

Zeabur

• Edge network for low latency
• Best performance globally
• Affordable pricing

​

Sealos

• Complete Kubernetes access
• Fine-grained resource control
• Advanced networking options

​

Environment Variable Generation

# JWT secrets (32-byte hex)
openssl rand -hex 32

# Credentials IV (16-byte hex)
openssl rand -hex 16

# Or use a secret generator
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

​

Post-Deployment Steps

CNAME: chat.yourdomain.com → your-app.platform.com

​

Troubleshooting

​

Deployment Fails

1. Check environment variables are set correctly
2. Verify API keys are valid
3. Check service logs in platform dashboard

​

Database Connection Issues

1. Verify MONGO_URI format
2. Check database service is running
3. Ensure network connectivity between services

​

Performance Issues

1. Increase resource limits (CPU/RAM)
2. Enable auto-scaling
3. Add Redis for caching

​

Migration Between Platforms

# Export MongoDB
mongodump --uri="mongodb://..." --out=./backup

# Export files
tar -czf uploads.tar.gz uploads/ images/

# Import MongoDB
mongorestore --uri="mongodb://..." ./backup

# Upload files to new storage

​

Next Steps

• Configure custom endpoints
• Set up OAuth authentication
• Explore Kubernetes deployment for advanced scaling