Deploy Ever Gauzy

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

Deploy Ever Gauzy

/var/lib/postgresql/data

Just deployed

/data

Just deployed

/srv/gauzy/apps/api/public

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

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.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0