---
title: "Deploy Ever Gauzy"
description: "Self-hosted ERP, CRM, HRM and project management: API, web, worker, DB"
category: "Other"
url: https://railway.com/deploy/ever-gauzy-1
---

# Deploy Ever Gauzy

Self-hosted ERP, CRM, HRM and project management: API, web, worker, DB

**[Deploy Ever Gauzy on Railway](https://railway.com/template/ever-gauzy-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/ever-gauzy-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Postgres https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/postgresql.png

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:17.11@sha256:5e806d28c18198f933d25e79989470a47a938f465bf0634e030b416961b3463e

### Redis https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/redis.png

- **Image:** redis:8.2.11-alpine@sha256:da23c2478319ceb4903857d77a2fd7aa5137d9e9d4c8165dafbacedac6403e95
- **Start command:** `/bin/sh -c "rmdir /data/lost+found 2>/dev/null; exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --appendonly yes --save 60 1 --dir /data"`

### Ever Gauzy https://cdn.jsdelivr.net/gh/ever-co/ever-gauzy@v111.142.11/apps/gauzy/src/assets/images/logos/logo_Gauzy_512x512.png

- **Source:** https://github.com/aalfath/ever-gauzy-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

### Gauzy Worker https://cdn.jsdelivr.net/gh/ever-co/ever-gauzy@v111.142.11/apps/gauzy/src/assets/images/logos/logo_Gauzy_512x512.png

- **Source:** https://github.com/aalfath/ever-gauzy-railway-template

### Gauzy API https://cdn.jsdelivr.net/gh/ever-co/ever-gauzy@v111.142.11/apps/gauzy/src/assets/images/logos/logo_Gauzy_512x512.png

- **Source:** https://github.com/aalfath/ever-gauzy-railway-template
- **Health check:** /api/health

## Documentation

# Deploy and Host Ever Gauzy on Railway

Ever Gauzy is an open-source (AGPL-3.0) business management platform from Ever Co. It combines ERP, CRM, HRM, applicant tracking, time and activity tracking, invoicing, expenses and project management in one web app, with multi-tenant organizations, roles and permissions, built on a NestJS API and an Angular front end.

## About Hosting Ever Gauzy

Ever Gauzy needs an API server, a web app, a background worker, PostgreSQL and Redis. This template deploys all five as separate Railway services on the private network, pinned to upstream release v111.142.11. The web service is the only public one: it serves the Angular app and proxies the API, uploaded files and GraphQL on the same domain. On its first start the API runs the database migrations and seeds a default tenant with a super admin. All secrets and account passwords are generated per deploy. The database, Redis and uploaded files are on volumes and survive redeploys and updates.

## Common Use Cases

* Run a self-hosted ERP and CRM for a small or medium business
* Track employees, time, timesheets, expenses and invoices in one place
* Manage projects, tasks, candidates and hiring pipelines for a team

## Dependencies for Ever Gauzy Hosting

* PostgreSQL 17 (included)
* Redis 8.2 (included)

### Deployment Dependencies

* [Ever Gauzy on GitHub](https://github.com/ever-co/ever-gauzy)
* [Template source and changelog](https://github.com/aalfath/ever-gauzy-railway-template)
* Optional: an SMTP account for invitation and notification emails

### Implementation Details

Services:

* **Ever Gauzy**: public web app (nginx). Proxies `/api`, `/public` and `/graphql` to the API, so the app uses one domain.
* **Gauzy API**: NestJS API. Runs migrations on every start; uploaded files live on its volume.
* **Gauzy Worker**: background queues and scheduled jobs (webhooks, reminders, clean-ups). Starts after the API is up.
* **Postgres** and **Redis**: database and sessions, cache and queues, each on its own volume.

After deploy:

1. Wait until all five services are green. The first API start runs migrations and the seed (a few minutes).
2. Open the Ever Gauzy domain and sign in with `DEMO_SUPER_ADMIN_EMAIL` (default `admin@ever.co`) and the generated `DEMO_SUPER_ADMIN_PASSWORD` from the Gauzy API service's Variables tab. Change the password.
3. The seed also creates `local.admin@ever.co` and `employee@ever.co` with generated passwords (`DEMO_ADMIN_PASSWORD`, `DEMO_EMPLOYEE_PASSWORD`). Change or remove them.
4. For email, add `MAIL_HOST`, `MAIL_PORT`, `MAIL_USERNAME`, `MAIL_PASSWORD` and `MAIL_FROM_ADDRESS` to Gauzy API and Gauzy Worker.
5. For a custom domain, add it to the Ever Gauzy service, set `API_BASE_URL`, `CLIENT_BASE_URL` and `ALLOWED_ORIGINS` on Gauzy API and `API_BASE_URL`, `CLIENT_BASE_URL` on Ever Gauzy to `https://YOUR-DOMAIN`, and redeploy both.

Keep `ENCRYPTION_KEY` unchanged: stored two-factor and integration secrets depend on it. Usage statistics to Ever are turned off.

Updates: the web, API and worker services build from the template's GitHub repo, with upstream images pinned by digest. When we pin a new Ever Gauzy release, Railway shows an update notice on your project. Read the changelog, then apply it to all three services; the API runs new migrations on start.

## Why Deploy Ever Gauzy on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Ever Gauzy on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/ever-gauzy-1
