From 704d5c7ace08c0d160fe95f08b4752eb6162a238 Mon Sep 17 00:00:00 2001
From: Jay-hub-engr <156174971+Jay-hub-engr@users.noreply.github.com>
Date: Fri, 8 Aug 2025 19:59:08 -0600
Subject: [PATCH] docs: added Railway deployment guide

---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index 33a5aac39..372c0c150 100644
--- a/README.md
+++ b/README.md
@@ -107,6 +107,33 @@ docker pull docker.umami.is/umami-software/umami:mysql-latest
 
 ---
 
+## 🚄 Deploying on Railway
+
+You can deploy Umami on [Railway](https://railway.app/) in just a few minutes.
+
+### Quick Deploy
+Click the button below to create a Railway project with Umami and PostgreSQL preconfigured:
+
+[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/YOUR_UMAMI_TEMPLATE_LINK)
+
+### Step-by-Step
+
+1. **Sign up / Log in** to [Railway](https://railway.app/).
+2. Click the **Deploy on Railway** button above.
+3. In your Railway project:
+   - Open the **Variables** tab and ensure:
+     | Variable        | Description                                        |
+     |-----------------|----------------------------------------------------|
+     | `DATABASE_URL`  | Set automatically when PostgreSQL service is added |
+     | `HASH_SALT`     | Generate a secure random string (32+ chars)        |
+   - Optional: Add other [Umami environment variables](https://umami.is/docs/environment-variables) if needed.
+4. Deploy the service and wait for the build to finish.
+5. Open the Railway **Shell** and run:
+   ```bash
+   npx prisma migrate deploy
+
+---
+
 ## 🔄 Getting Updates
 
 To get the latest features, simply do a pull, install any new dependencies, and rebuild: