Railway

​

Railway Template

​

What the Template Includes

• PostgreSQL Database: Managed PostgreSQL instance
• API Service: Pre-configured Hono API server
• Web Service: Pre-configured React web application
• Environment Variables: All required variables with sensible defaults
• Networking: Proper service discovery and internal communication
• Build Configuration: Optimized Docker builds for both services

​

Deployment Steps

1. Click the Deploy Button above to open the Railway template
2. Connect to Railway (sign up or log in if needed)
3. Configure Environment Variables:
   • Set your AUTH_SECRET (minimum 32 characters)
   • Review other environment variables as needed
4. Deploy - Railway will build and deploy all services automatically

​

Post-Deployment Setup

1. Access Your Application: Railway will provide URLs for both services
2. Create Admin Account: Visit the web application to create your first user
3. Configure Domain (optional): Add custom domains in Railway dashboard
4. Set Up SSO (optional): Configure GitHub, Google, or other providers

​

Environment Variables

# Railway automatically sets these
DATABASE_URL=postgresql://postgres:password@host:port/database
KANEO_API_URL=https://your-api.railway.app
KANEO_CLIENT_URL=https://your-web.railway.app

# You may want to customize these
AUTH_SECRET=your-32-character-secret-here
CORS_ORIGINS=https://your-web.railway.app

​

Monitoring and Scaling

• Health Checks: Automatic service monitoring
• Logs: Centralized logging for all services
• Metrics: Performance and usage analytics
• Scaling: Easy horizontal scaling when needed

​

Troubleshooting

1. Check Logs: Use Railway’s log viewer to debug
2. Verify Environment: Ensure all required variables are set
3. Redeploy: Sometimes a fresh deployment resolves issues
4. Check Resource Usage: Free tier has limitations