🧭 Decision Guide
Why trending now: Cannot be determined from the provided material.
Try it if you
-
You need ERP, CRM, HRM, ATS, and PM in one business platform.The README sections “What is it” and “Features” list these modules.
-
Your frontend uses React/NextJs and you want to connect to Headless APIs.The README section “What's New” says Ever Teams uses React/NextJs and connects to Ever Gauzy Platform APIs.
-
You want to explore the demo quickly with Docker Compose v2.20 or later.The README section “Run with Docker Compose” requires v2.20 minimum and provides docker-compose.demo.yml.
Skip it if you
-
You require a production-grade platform that is not in Alpha/testing.The README marks it as Alpha version/testing mode in “Super Quick Start” and the SaaS link notes.
-
You need advanced dynamic reporting but do not plan to deploy Cube.The production dependency notes say that without Cube, some advanced dynamic reporting and data processing capabilities are disabled.
-
You need Jitsu-based data ingestion and real-time pipelines but will not deploy Jitsu.The README says data ingestion for additional analyses and real-time pipelines is disabled without Jitsu.
Requirements
- Docker Compose minimum version is v2.20.
- For production, the README recommends PostgreSQL 14 or later, with 16.x recommended.
- SQLite is the default database and is recommended only for testing/demo; production can use PostgreSQL or MySQL.
- For production, Kubernetes or Docker is recommended, along with Redis, OpenSearch, MinIO/LocalStack, Jitsu, and Cube.
- Production communication should use HTTPS/WSS/SSL for REST APIs, GraphQL, and Socket.io WebSockets.
First step (verbatim from README)
docker-compose -f docker-compose.demo.yml up
Watch out
-
The demo database usually resets daily, so demo data is not persistent.The README section “Demo” says the demo DB resets on each deployment, usually daily.
-
Without Redis, the platform uses in-memory caching rather than distributed caching; Jitsu still requires Redis.The production dependency notes distinguish in-memory caching without Redis and state that Jitsu requires Redis.
-
Without OpenSearch, the platform falls back to built-in database search capabilities.The production dependency notes state that the platform uses DB built-in search capabilities without OpenSearch.
-
The README demo Super Admin credentials are [email protected] / admin.The README section “Demo” provides the default Super Admin email and password.
Alternatives
-
Ever Teams:If you mainly need an Open Work & Productivity Platform rather than the full ERP/CRM/HRM suite, the README provides Ever Teams.README “What's New”
Not stated in the README
- The README excerpt does not provide the complete Super Quick Start command.
- The README excerpt does not specify production CPU, memory, storage, or concurrency requirements.
- The README excerpt does not provide a version compatibility matrix for TypeScript, Node.js, Angular, NestJS, and Nx.
- The README excerpt does not provide automated test coverage, performance benchmarks, or disaster-recovery metrics.
- The README excerpt does not explain Headless APIs authentication, rate limits, or API compatibility guarantees.
- The README excerpt does not clarify the boundary between the Community Edition License and AGPL v3 or the enterprise licensing terms.
💡 Deep Analysis
6
Yes
We only want to try Gauzy’s Projects, Time Tracking, and Invoicing without configuring Kubernetes. Docker Compose v2.20 is already installed locally. Can we start the demo quickly?
Yes, the README provides a direct Docker Compose path for this evaluation scenario, but the environment must not be treated as production.
- The Run with Docker Compose section requires Docker Compose v2.20 or newer, matching your constraint.
- The demo command starts a basic configuration using prebuilt Docker images, and the README describes it for Demo, exploring functionality, and quick runs.
- The demo provides
[email protected]/adminfor the Super Admin role and[email protected]/12345678for the Employee role, allowing role and workflow checks immediately. - The README says the demo database is usually reset daily and that images are built from the master branch through CI/CD, so its data and version state are unsuitable for real business operations.
- Run with Docker Compose: you need a minimum v2.20
- Run with Docker Compose / Demo: docker-compose.demo.yml; prebuilt Docker images; Demo / explore functionality / quick run
- Demo: Default super-admin user login ...; Employee user login ...
- Demo: Content of demo DB resets ... usually daily; develop/master branch CI/CD
docker-compose -f docker-compose.demo.yml up
No
We want to enable Activity Tracking, Productivity Tracking, and Performance Monitoring while employees use Time Tracking and Timesheets. Is Gauzy suitable for using those signals directly as performance evidence?
No, it is not suitable to treat these tracking signals directly as performance conclusions, because the README only describes monitoring and productivity features and does not establish that the data represents employee performance or satisfies labor requirements.
- The feature list includes Time Management, Time Tracking, Activity Tracking, Timesheets, and Employees Performance Monitoring, showing that the platform can collect related operational data.
- Gauzy targets collaborative, on-demand, and sharing economies and supports both employees and contractors, so data subjects and employment relationships may vary.
- The project insight explicitly warns that time-tracking or activity-monitoring data must not be equated directly with performance and calls for privacy boundaries, notice, performance metrics, and management rules.
- The Security section discusses encrypted communications and vulnerability disclosure, but does not specify retention periods, access auditing, deletion workflows, or labor-law handling by jurisdiction.
- Features: Time Management / Time Tracking / Activity Tracking / Timesheets
- Features: Employees Performance Monitoring
- What is it: Collaborative, On-Demand and Sharing Economies
- Project insight common_pitfalls: do not equate time-tracking or activity-monitoring data directly with employee performance
Yes
Our team uses TypeScript, NestJS, and Angular/RxJS, but wants to connect client, project, time, and invoice data to a custom React/Next.js frontend. Is Gauzy’s Headless API suitable for this architecture?
Yes, provided the team is willing to integrate with Gauzy’s permission and business-data model rather than treating it as a small set of simple CRUD endpoints.
- The detailed feature list explicitly provides Headless APIs and links to API documentation, indicating that the presentation layer can be separated from the platform.
- The stack is primarily TypeScript, with NodeJs / NestJs on the backend and Angular, RxJS, and Ngx-admin on the frontend, which aligns with a TypeScript server-side team.
- The README’s “What’s New” section says that Ever Teams uses React, NextJs, ReactNative, and Expo and connects to headless Ever Gauzy Platform APIs, showing an explicit non-Angular client direction.
- The provided README does not detail authentication, permission mapping, pagination, idempotency, event consistency, or API-version compatibility.
- Features: Headless APIs
- Technology Stack and Requirements: TypeScript, NodeJs / NestJs, Angular / RxJS / Ngx-admin
- What's New: Ever Teams ... React (NextJs) / ReactNative (Expo) ... connects to headless Ever Gauzy Platform APIs
It depends
We want to integrate Gauzy’s Headless APIs into a closed-source SaaS and expose client, project, and time capabilities to customers over the network without publishing all modifications. Is that commercialization model suitable under AGPLv3 and the Community Edition license?
It depends. You cannot assume that a closed-source network integration has no licensing obligations merely because the project is open source; the boundaries between Community Edition, Enterprise, and Small Business must be clarified before commercialization.
- Project data identifies the license as GNU Affero General Public License v3.0, whose network-service requirements are particularly relevant when modified software is offered over a network.
- The README’s License section states that without a valid Enterprise or Small Business License agreement, the default is the Community Edition License.
- The README directs users to the LICENSE file and to “compare our offering,” indicating that the licensing arrangement is not determined solely by the repository’s open-source label.
- Headless APIs do support connecting the business capabilities to a proprietary product, but the supplied README does not analyze, case by case, API-only use, modifications, derivative-work status, or source-offer obligations for network services.
- Project data: license = GNU Affero General Public License v3.0
- License section: The default ... license ... without a valid ... Enterprise or ... Small Business License agreement ... Community Edition License
- License section: Please see LICENSE for more information on licenses; compare our offering
- Features: Headless APIs
Yes
We run an agency with CRM, project-management, and HRM workflows, and need multiple organizations, employee time tracking, client billing, and multi-currency revenue. Is Gauzy suitable as a unified business platform?
Yes, because Gauzy covers the main agency workflow from workforce input to client revenue, although complex accounting or local payroll may still require external systems.
- The README positions it as an ERP, CRM, HRM, ATS, and project-management platform, and explicitly mentions agencies, studios, freelance businesses, and in-house teams.
- Its feature list includes employee/contractor rates, Time Tracking, Timesheets, Projects, Accounting, Invoicing, Billing, Payments, and Income / Expenses Management.
- It supports Multiple Organizations Management, Departments and Teams, Roles / Permissions, Multi-currency, and Multi-lingual operations.
- The README does not establish compliance with any particular country’s tax, accounting, or payroll rules, so the feature list alone is not evidence that it replaces a mature finance or payroll system.
- What is it: ERP, CRM, HRM, ATS, PM, and Employee Time-Tracking
- Features: Employees Management, Projects / Tasks, Accounting / Invoicing, and Billing
- Features: Multiple Organizations Management, Roles / Permissions, Multi-currency, and Multi-lingual
- Project insight: it does not necessarily replace mature ERP, finance, or payroll systems in every industry
It depends
I need PostgreSQL, Docker or Kubernetes in production and must encrypt REST, GraphQL, and Socket.io WebSockets with HTTPS/WSS. Is Gauzy suitable for self-hosting?
It depends: the deployment path matches your constraints, but this is not a lightweight service that ends with starting one container; production operability is decisive.
- The README’s production recommendations explicitly list PostgreSQL or MySQL and Kubernetes or Docker, matching the intended environment.
- The Docker Compose demo requires Docker Compose v2.20 or newer and is described as a Demo / explore functionality / quick run configuration, not as a production configuration.
- The Security section explicitly requires HTTPS/WSS/SSL for client-to-backend traffic, REST APIs, the GraphQL endpoint, and Socket.io WebSockets in production.
- The supplied README does not fully specify production topology, backup and recovery, high availability, upgrade rollback, or resource requirements, so fit for a particular SLA remains dependent on deployment design.
- Technology Stack and Requirements: For Production, we recommend PostgreSQL or MySQL; Kubernetes and Docker
- Run with Docker Compose: minimum v2.20
- Security: communications ... should be encrypted using HTTPS/WSS/SSL ... REST APIs, GraphQL endpoint, Socket.io WebSockets
- Project insight: production deployment involves database, cache, search, object storage, real-time communication, and analytics operations
✨ Highlights
-
Combines ERP, CRM, HRM, ATS, and PM in one platform
-
Provides Headless APIs and multi-organization management
-
Docker Compose v2.20 can launch the demo environment
-
Supports PostgreSQL, MySQL, and SQLite
🔧 Engineering
-
Covers HRM, CRM, ERP, ATS, project, and task management
-
Headless APIs support Ever Teams built with React/NextJs
-
Includes time tracking, invoicing, inventory, reporting, and multi-currency
⚠️ Risks
-
The README labels it Alpha/testing and asks users to proceed cautiously
-
SQLite is recommended only for testing/demo; production recommends PostgreSQL 14+
-
Missing Redis, Jitsu, or Cube disables some capabilities
-
The AGPL v3 badge and Community Edition License require license review
👥 For who?
-
Organizations needing integrated ERP, CRM, HRM, ATS, and PM
-
Development teams using TypeScript, Angular, and NestJS
-
Teams able to deploy with Docker Compose or Kubernetes