ื“ืœื’ ืœืชื•ื›ืŸ ื”ืจืืฉื™

Frequently Asked Questions

Common questions about Ever Gauzy.

Generalโ€‹

What is Ever Gauzy?โ€‹

Ever Gauzy is an open-source business management platform that includes time tracking, project management, invoicing, CRM, HR management, and more. It's built with NestJS (backend), Angular (frontend), and supports PostgreSQL/SQLite databases.

Is Ever Gauzy free?โ€‹

Yes! Ever Gauzy is open-source under the AGPL-3.0 license. You can self-host it for free. Commercial licenses are also available.

What's the difference between Ever Gauzy and Ever Teams?โ€‹

Ever Gauzy is the full business management platform. Ever Teams is a focused team collaboration and time tracking app built on top of the Gauzy API.

Technicalโ€‹

Which databases are supported?โ€‹

  • PostgreSQL (recommended for production)
  • SQLite (development only)
  • Multi-ORM support (TypeORM and MikroORM)

What Node.js version is required?โ€‹

Node.js 20 or later.

Can I use Docker?โ€‹

Yes! Docker images are available at ghcr.io/ever-co/gauzy-api and ghcr.io/ever-co/gauzy-webapp. See Production Deployment.

How do I upgrade?โ€‹

  1. Pull latest Docker images (or git pull)
  2. Run database migrations: yarn typeorm migration:run
  3. Restart services

Featuresโ€‹

Can I track time offline?โ€‹

Yes, the desktop app supports offline time tracking. Data syncs when connection is restored.

How do I customize invoice templates?โ€‹

Go to Settings โ†’ Accounting Templates. Use the MJML/Handlebars editor. See Accounting Templates.

Can I integrate with GitHub/Jira?โ€‹

Yes! Gauzy supports integrations with GitHub, GitLab, Jira, Hubstaff, Upwork, and more. See Integrations.

How does multi-tenancy work?โ€‹

Each tenant is a separate workspace with its own data, isolated at the database row level. See Multi-Tenancy.

Deploymentโ€‹

What are the minimum system requirements?โ€‹

  • 2GB RAM for the API server
  • 1 CPU core
  • 10GB disk space
  • PostgreSQL 14+
  • Redis 6+ (for scalable deployments)

Can I deploy on shared hosting?โ€‹

Not easily. Gauzy requires Node.js runtime, a PostgreSQL database, and ideally Redis. Use a VPS, cloud VM, or container platform.