---
title: "Deploy Gauzy ERP"
description: "Open source ERP, CRM and HRM platform. One-click deploy with PostgreSQL."
category: "Other"
url: https://railway.com/deploy/gauzy-erp
---

# Deploy Gauzy ERP

Open source ERP, CRM and HRM platform. One-click deploy with PostgreSQL.

**[Deploy Gauzy ERP on Railway](https://railway.com/template/gauzy-erp)**

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

- **Creator:** Auromations
- **Category:** Other
- **Total deploys:** 3

## Template content

### webapp https://raw.githubusercontent.com/ever-co/ever-gauzy/cb186969327ff3bc5787f1b793c875aeb4d59c8c/apps/gauzy/src/assets/images/logos/logo_Gauzy_512x512.png

- **Image:** ghcr.io/ever-co/gauzy-webapp:latest
- **Start command:** `/bin/sh -c "cd /srv/gauzy && (grep -qF '[::]:4200' /etc/nginx/conf.d/prod.conf.template || sed -i 's/listen 4200;/listen 4200; listen [::]:4200;/' /etc/nginx/conf.d/prod.conf.template) && exec ./entrypoint.prod.sh nginx -g 'daemon off;'"`
- **Health check:** /
- **Public domain:** Yes

### api https://raw.githubusercontent.com/ever-co/ever-gauzy/cb186969327ff3bc5787f1b793c875aeb4d59c8c/apps/gauzy/src/assets/images/logos/logo_Gauzy_512x512.png

- **Image:** ghcr.io/ever-co/gauzy-api:latest
- **Health check:** /api/health
- **Public domain:** Yes

### db https://devicons.railway.app/i/postgresql.svg

- **Image:** postgres:17-alpine

## Documentation

# Deploy and Host Gauzy on Railway

Gauzy is an open source business management platform (ERP, CRM, HRM, ATS and project management) built by Ever. This template deploys the full stack in one click: the Gauzy API, the Gauzy web app, and a PostgreSQL database, with all secrets and the admin password generated per deploy.

## About Hosting Gauzy

Gauzy is a NestJS API plus an Angular web app backed by PostgreSQL. On first boot the API runs its database migrations and seeds a default tenant, so the first deploy takes a couple of minutes before the healthcheck goes green. Uploads are stored on a persistent volume attached to the API service. Outbound email (invites, confirmations) is off until you add your own SMTP settings to the api service variables: MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD and MAIL_FROM_ADDRESS.

## Common Use Cases

- Run a self-hosted ERP and CRM for a small business
- Track employees, time, expenses and invoices in one place (HRM)
- Manage candidates and hiring pipelines (ATS)
- Evaluate Gauzy before moving to Ever's hosted offering

## Dependencies for Gauzy Hosting

### Deployment Dependencies

Everything is included in the template; no external accounts are required.

- **db**: PostgreSQL 17 (postgres:17-alpine) with a persistent volume
- **api**: Gauzy API (ghcr.io/ever-co/gauzy-api:latest) with a persistent volume for uploaded files
- **webapp**: Gauzy web UI (ghcr.io/ever-co/gauzy-webapp:latest)

Upstream moves the latest tag only when it ships a stable release (v111.142.11 when this template was last tested), so a new deploy gets the newest stable Gauzy.

Upstream's full docker-compose stack also ships Redis, MinIO, OpenSearch, Cube, Zipkin and Jitsu. Newer releases also add a separate worker service. Those are optional analytics, tracing, queue and object-storage extras, so this template leaves them out: sessions and cache run in memory, and files are stored on the API volume. Without Redis and the worker, outbound webhooks and live event updates are not delivered; everything else works. Add them back later if you need them.

### Implementation Details

**Logging in.** On first boot Gauzy seeds a super admin. The email is DEMO_SUPER_ADMIN_EMAIL on the api service (default admin@ever.co) and the password is the generated DEMO_SUPER_ADMIN_PASSWORD value shown right below it in the api service variables. Sign in at your webapp URL, then change the password.

The same seed also creates two more accounts: local.admin@ever.co (admin) with the generated DEMO_ADMIN_PASSWORD, and employee@ever.co (employee) with the generated DEMO_EMPLOYEE_PASSWORD. Change or remove them if you do not need them.

**First boot.** The API runs migrations and a full default seed before it starts listening. Measured at about 90 seconds, well inside the healthcheck window. If the first deploy ever times out, redeploy the api service once; the seed resumes where it left off.

**Optional variables.**

- DEMO_SUPER_ADMIN_EMAIL: pick your own admin email before deploying, or keep the default.
- EVER_STATS_ENABLED: Gauzy can send anonymous usage statistics to Ever. This template sets it to false; set true to opt in.
- ENCRYPTION_KEY is generated per deploy and encrypts stored AI provider and SMTP credentials. Keep it: if it changes, those stored credentials can no longer be read.
- SMTP settings (above) for transactional email through your own provider.
- GAUZY_GITHUB_* variables if you want the GitHub integration; see the upstream docs.

**Troubleshooting.**

- Web app loads but cannot reach the API: hard refresh once. The API address is substituted into the web app at container start.
- Login fails with the generated password: the seed only creates the admin when the database is empty, so the password is the one from the first successful boot of that project.
- API restarts during the very first boot: normal while migrations run; it stabilizes on its own.

**Upgrading.** Both Gauzy images use the latest tag, which upstream moves only on stable releases. Redeploy the api and the webapp together to pick up a new release. The API runs new migrations automatically on boot. Deploys made from this template before November 2026 were pinned to a mid-2026 release. To move one to latest, also add ENCRYPTION_KEY to the api service (43 random letters and digits) and set DEMO_ADMIN_PASSWORD and DEMO_EMPLOYEE_PASSWORD. Those older deploys seeded local.admin@ever.co with the password admin and employee@ever.co with the password 12345678. Change both passwords now if you have not already.

## Why Deploy Gauzy on Railway?

Railway gives Gauzy the three things it needs without any YAML: a private network between the API and PostgreSQL, persistent volumes for the database and uploads, and public domains for the API and web app with TLS handled at the edge. One click gets you a running ERP; scaling later is a slider, not a migration.


## 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/gauzy-erp
