commit 824e02acd0932963bba7915ffbd6450d3d594ccd
Author: So <kanon.kevelop@gmail.com>
Date:   Tue Mar 3 19:11:17 2026 +0200

    Initial LiteLLM API Gateway Railway template
    
    Multi-service deploy: LiteLLM proxy + PostgreSQL + Redis.
    Universal LLM gateway with 100+ provider support.
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..6b1e8b7
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,8 @@
+FROM ghcr.io/berriai/litellm-database:main-stable
+
+COPY --chmod=755 entrypoint.sh /app/entrypoint.sh
+COPY config.yaml /app/config.yaml
+
+EXPOSE 4000
+
+ENTRYPOINT ["/app/entrypoint.sh"]
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8ba7f35
--- /dev/null
+++ b/README.md
@@ -0,0 +1,83 @@
+# LiteLLM API Gateway
+
+One-click deploy of [LiteLLM](https://litellm.ai) on Railway -- a universal API gateway for 100+ LLM providers with OpenAI-compatible endpoints, spend tracking, rate limiting, and load balancing.
+
+[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/template/TEMPLATE_CODE)
+
+## Services Included
+
+- **LiteLLM Proxy** -- API gateway with admin UI, virtual keys, and usage analytics
+- **PostgreSQL** -- Stores API keys, spend logs, model configurations, and user data
+- **Redis** -- Response caching and rate limiting
+
+## Environment Variables
+
+### Required
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `LITELLM_MASTER_KEY` | Admin API key (must start with `sk-`) | Auto-generated |
+| `LITELLM_SALT_KEY` | Encryption key for stored API keys (do not change after setup) | Auto-generated |
+| `DATABASE_URL` | PostgreSQL connection string | Auto-configured |
+
+### LLM Provider Keys (add the ones you need)
+
+| Variable | Description |
+|----------|-------------|
+| `OPENAI_API_KEY` | OpenAI API key |
+| `ANTHROPIC_API_KEY` | Anthropic API key |
+| `AZURE_API_KEY` | Azure OpenAI API key |
+| `AZURE_API_BASE` | Azure OpenAI endpoint URL |
+| `COHERE_API_KEY` | Cohere API key |
+| `MISTRAL_API_KEY` | Mistral API key |
+| `GROQ_API_KEY` | Groq API key |
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `AWS_ACCESS_KEY_ID` | AWS access key (for Bedrock) |
+| `AWS_SECRET_ACCESS_KEY` | AWS secret key (for Bedrock) |
+| `AWS_REGION_NAME` | AWS region (for Bedrock) |
+
+### Optional
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `REDIS_HOST` | Redis hostname | Auto-configured |
+| `REDIS_PORT` | Redis port | Auto-configured |
+| `REDIS_PASSWORD` | Redis password | Auto-configured |
+| `NUM_WORKERS` | Number of proxy workers | `(auto)` |
+| `STORE_MODEL_IN_DB` | Store model config in database | `True` |
+
+## Post-Deployment
+
+1. Visit your LiteLLM URL to access the Admin UI
+2. Log in with your `LITELLM_MASTER_KEY`
+3. Add models via the UI or API (models are stored in the database when `STORE_MODEL_IN_DB=True`)
+4. Create virtual API keys for your applications
+5. Point your apps to `https://your-litellm-url/v1/` as the OpenAI base URL
+
+## Adding Models
+
+### Via Admin UI
+Navigate to your LiteLLM URL and use the model management interface.
+
+### Via API
+```bash
+curl -X POST https://your-litellm-url/model/new \
+  -H "Authorization: Bearer sk-your-master-key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model_name": "gpt-4o",
+    "litellm_params": {
+      "model": "openai/gpt-4o",
+      "api_key": "sk-your-openai-key"
+    }
+  }'
+```
+
+### Via Config File
+Edit `config.yaml` in the repo and redeploy.
+
+## Links
+
+- [LiteLLM Documentation](https://docs.litellm.ai/)
+- [Supported Providers](https://docs.litellm.ai/docs/providers)
+- [Source Code](https://github.com/BerriAI/litellm)
diff --git a/config.yaml b/config.yaml
new file mode 100644
index 0000000..143c667
--- /dev/null
+++ b/config.yaml
@@ -0,0 +1,32 @@
+model_list:
+  - model_name: gpt-4o
+    litellm_params:
+      model: openai/gpt-4o
+      api_key: os.environ/OPENAI_API_KEY
+  - model_name: gpt-4o-mini
+    litellm_params:
+      model: openai/gpt-4o-mini
+      api_key: os.environ/OPENAI_API_KEY
+  - model_name: claude-sonnet-4-20250514
+    litellm_params:
+      model: anthropic/claude-sonnet-4-20250514
+      api_key: os.environ/ANTHROPIC_API_KEY
+  - model_name: claude-haiku-3.5
+    litellm_params:
+      model: anthropic/claude-3-5-haiku-20241022
+      api_key: os.environ/ANTHROPIC_API_KEY
+
+general_settings:
+  master_key: os.environ/LITELLM_MASTER_KEY
+  database_url: os.environ/DATABASE_URL
+  store_model_in_db: true
+
+litellm_settings:
+  drop_params: true
+  set_verbose: false
+  cache: true
+  cache_params:
+    type: redis
+    host: os.environ/REDIS_HOST
+    port: os.environ/REDIS_PORT
+    password: os.environ/REDIS_PASSWORD
diff --git a/entrypoint.sh b/entrypoint.sh
new file mode 100644
index 0000000..d56de09
--- /dev/null
+++ b/entrypoint.sh
@@ -0,0 +1,14 @@
+#!/bin/bash
+set -e
+
+echo "Starting LiteLLM Proxy..."
+
+# Build startup command
+CMD_ARGS="--config /app/config.yaml --port 4000"
+
+if [ -n "$NUM_WORKERS" ]; then
+    CMD_ARGS="$CMD_ARGS --num_workers $NUM_WORKERS"
+fi
+
+echo "Launching LiteLLM with: $CMD_ARGS"
+exec litellm $CMD_ARGS
diff --git a/railway.json b/railway.json
new file mode 100644
index 0000000..bbaa983
--- /dev/null
+++ b/railway.json
@@ -0,0 +1,13 @@
+{
+  "$schema": "https://railway.com/railway.schema.json",
+  "build": {
+    "builder": "DOCKERFILE",
+    "dockerfilePath": "Dockerfile"
+  },
+  "deploy": {
+    "healthcheckPath": "/health/liveliness",
+    "healthcheckTimeout": 300,
+    "restartPolicyType": "ON_FAILURE",
+    "restartPolicyMaxRetries": 3
+  }
+}