# Railway Deployment Guide {#railway-deployment-guide}


Deploy Ever Gauzy to Railway with one-click setup.


## Prerequisites {#prerequisites}


- Railway account at [railway.app](https://railway.app)


## Quick Start {#quick-start}



### 1. Create Project {#1-create-project}


1. Go to Railway dashboard
2. Click **New Project** → **Deploy from GitHub repo**
3. Select `ever-co/ever-gauzy`


### 2. Add Services {#2-add-services}


Add from the Railway marketplace:

- **PostgreSQL** — database
- **Redis** — caching


### 3. Configure Variables {#3-configure-variables}


Railway auto-connects services. Add custom variables:

```
NODE_ENV=production
JWT_SECRET=your-secret
JWT_REFRESH_SECRET=your-refresh-secret
API_BASE_URL=https://gauzy-api.up.railway.app
CLIENT_BASE_URL=https://gauzy-webapp.up.railway.app
FILE_PROVIDER=LOCAL
```


### 4. Deploy {#4-deploy}


Railway auto-deploys on push. Manual deploy:

```bash
railway up
```


## Railway-Specific Notes {#railway-specific-notes}


- `DATABASE_URL` and `REDIS_URL` are auto-injected
- SSL is automatic
- Custom domains supported with free SSL
- Automatic scaling based on load


## Related Pages {#related-pages}


- [Production Deployment](https://sourcey-gauzy.pages.dev/devops/production-deployment/index.md) — general guide
- [Fly.io Deployment](https://sourcey-gauzy.pages.dev/deployment/cloud/flyio-deployment/index.md) — Fly.io alternative