📊 Activity


💻 Demo, Downloads, Testing and Production

Demo

Ever Gauzy Platform Demo at .

Notes:

• Default super-admin user login is [email protected] and the password is admin
• Content of demo DB resets on each deployment to the demo environment (usually daily)
• Demo environment deployed using CI/CD from the develop branch

Downloads

You can download Gauzy Platform, Gauzy Server, or Desktop Apps (Windows/Mac/Linux) from the official Downloads page.

In addition, all releases and pre-releases downloads are also available from the following pages:

• Platform Releases
• Apps

Production (SaaS)

Ever® Gauzy™ Platform SaaS is available at .

Note: it's currently in Alpha version/testing mode, please use it cautiously!

Staging

• Gauzy Platform Staging builds (using CI/CD, from the stage branch) are available at
• We are using the Staging environment to test releases before they are deployed to the production environment
• Our pre-releases of desktop/server apps are built from this environment and can be configured manually (in settings) to connect to Stage API:

Server & Desktop Apps

We have Gauzy Server and two Desktop Apps (for Windows/Mac/Linux):

• Ever® Gauzy™ Server - includes Gauzy API, SQLite DB (or connects to external PostgreSQL) and serves Guazy frontend. It allows to quickly run Gauzy Server for multiple clients (browser-based or Desktop-based). It's a recommended option if you want to setup the Ever Gauzy Platform in small to medium organizations.
• Ever® Gauzy™ Desktop App - includes Gauzy frontend (UI), Gauzy API, SQLite DB, etc., all-in-one! It allows to quickly run the whole Gauzy solution locally, both UI and Timer (for time tracking, optionally of course). In addition, it allows you to connect to the external database (e.g. PostgreSQL) or external API (if you have Gauzy Server with API / DB installed on a different computer or if you want to connect to our live API). It's a recommended option if you want to try Gauzy quickly / for personal use or if you want to connect to Gauzy Server in the "client-server" configuration (and use Desktop App instead of web browser).
• Ever® Gauzy™ Desktop Timer App - allows running Time and Activity Tracking for employees/contractors with screenshots and activity monitoring. It is recommended to setup by organization employees as long as they are not interested in other Gauzy Platform features (e.g. accounting) and only need to track work time.

• Download for your OS from the official Downloads page or see the section "Download" above for other links to our releases pages.
• Setup Gauzy Server with default choices in Setup Wizard and run it.
• You can also setup Gauzy Desktop App (can run independently or connect to Gauzy Server) or Gauzy Desktop Timer App (should be connected to Gauzy Server)
• You can login with [email protected] and password admin to check Admin functionality if you installed Gauzy Server or Gauzy Desktop App. Note: such an Admin user is not an employee, so you will not be able to track time.
• You can login with [email protected] and password 12345678 to check Employee-related functionality in Gauzy UI or to run Desktop Timer from an "Employee" perspective (such a user is an Employee and can track time).
• If you install Gauzy Server, it is possible to connect to it using a browser (by default on ) or using Gauzy Desktop Apps (make sure to configure Desktop apps to connect to Gauzy API on because it's where Gauzy Server API runs by default).
• You can read more information about our Desktop Apps on the Desktop Apps Wiki Page and our Server at the Server Wiki Page.

🧱 Technology Stack and Requirements

• TypeScript
• NodeJs / NestJs
• Nx / Lerna
• Angular / RxJS / Ngx-admin
• TypeORM / MikroORM / Knex

• PostgreSQL or MySQL
• Kubernetes, Docker

See also README.md and CREDITS.md files in relevant folders for lists of libraries and software included in the Platform, information about licenses, and other details

📄 Documentation

Please refer to our official Platform Documentation and our Wiki (WIP).

🚀 Quick Start

Super Quick Start

.

Note: it's currently in Alpha version/testing mode, please use it cautiously!

Run with Docker Compose

• Clone repo.
• Make sure you have the latest Docker Compose installed locally. Important: you need a minimum v2.20.

Demo

• Run docker-compose -f docker-compose.demo.yml up, if you want to run the platform in basic configuration (e.g. for Demo / explore functionality / quick run) using our prebuilt Docker images. Check .env.demo.compose file for different settings (optionally), e.g. DB type. _(Note: Docker Compose will use latest images pre-build automatically from head of master branch using GitHub CI/CD.)_
• Open in your browser.
• Login with email [email protected] and password: admin for Super Admin user.
• Login with email [email protected] and password: 12345678 for Employee user.
• Enjoy!

Production

Build

• Edit .env.compose (if needed) to use your custom settings, e.g. DB type.
• Run docker-compose -f docker-compose.build.yml up -d, if you want to build everything (code and Docker images) locally. _(Note: this is extremely long process because it builds whole platform locally. Other options above are much faster!)_
• :coffee: time... It might take some time for our API to seed fake data in the DB during the first Docker Compose run, even if you used prebuilt Docker images.

• while demo docker-compose.demo.yml runs a minimum amount of containers (API, Web UI, and DB), other Docker Compose files run multiple infrastructure dependencies (see full list below).
• you can also run ONLY infra dependencies (without our API / Web containers) with docker-compose -f docker-compose.infra.yml up -d command. We already doing it using include in our main docker compose files.
• you can add something like --env-file .env.something to the docker-compose up command to instruct Docker Compose to use a specific .env.something file with your custom settings

• PostgreSQL - Primary Database.
• Pgweb - Cross-platform client for PostgreSQL DBs, available on .
• OpenSearch - Search Engine.
• OpenSearch Dashboards - Search Engine Dashboards, available on . Default username: admin and password: Gauzy_password_123
• Dejavu - Web UI for OpenSearch, available on .
• MinIO - Multi-Cloud ☁️ Object Storage (AWS S3 compatible).
• Jitsu - Jitsu is an open-source Segment alternative (data ingestion engine).
• Redis - In-memory data store/caching (also used by Jitsu)
• Cube - "Semantic Layer" used for Reports, Dashboards, Analytics, and other BI-related features, with UI available on .
• Zipkin - distributed tracing system.

Quick Start to manually build & run

Required

• Install NodeJs LTS version or later (e.g. version 22.x or 24.x).
• Install Yarn v1.22.x (if you don't have it) with npm i -g yarn.
• Install NPM packages and Bootstrap solution using the command yarn bootstrap.
• If you will need to make code changes (and push to Git repo), please run yarn prepare:husky.
• Adjust settings in the .env.local which is used in local runs.
• Alternatively, you can copy .env.sample to .env and change default settings there, e.g. database type, name, user, password, etc.
• Run both API and UI with a single command: yarn start.
• Open Gauzy UI on in your browser (API runs on ).
• Login with email [email protected] and password: admin for Super Admin user.
• Login with email [email protected] and password: 12345678 for Employee user.
• Enjoy!

• during the first API start, DB will be automatically seeded with a minimum set of initial data if no users are found.
• you can run seed any moment manually (e.g. if you changed entities schemas) with the yarn seed command to re-initialize DB (warning: unsafe for production!).
• it is possible to run generation of extremely large amounts of fake data for demo purposes/testing with yarn seed:all (warning: takes ~10 min to complete)

Optional / Recommended for Production

• Optionally (recommended for production) install and run PostgreSQL version 14 or later (16.x recommended for production). Note: other DB can be configured manually in TypeORM / MikroORM / Knex. The default DB is set to SQLite (recommended for testing/demo purposes only).
• Optionally (recommended for production) install and run Redis. Notes: the platform will work without Redis using an in-memory caching strategy instead of a distributed one (recommended for testing/demo purposes only). Please note however that Redis is required for Jitsu.
• Optionally (recommended for production) install and run OpenSearch. Note: the platform will work without OpenSearch using DB build-in search capabilities (recommended for testing/demo purposes only).
• Optionally install and run MinIO or LocalStack. Note: the platform will work without MinIO / LocalStack or other S3-compatible storage using local filesystem-based storage (recommended for testing/demo purposes only). For production, we recommend using Wasabi or AWS S3 storage or another S3-compatible cloud storage.
• Optionally (recommended for production) install and run Jitsu. Note: the platform will work without Jitsu, however, data ingestion will be disabled for additional analyses / real-time pipelines.
• Optionally (recommended for production) install and run Cube. Note: the platform will work without Cube, however some advanced (dynamic) reporting and data processing capabilities will be disabled.

🏭 Production

General information

• See Setup Gauzy for Client Server for more information about production setup on your servers.

Kubernetes

• We recommend deploying to Kubernetes (k8s), either manually (see below) or with our Terraform Modules or Ever Helm Charts.
• For more simple deployment scenarios with k8s, please see Kubernetes configurations, which we are using to deploy Gauzy into DigitalOcean k8s cluster.

DigitalOcean App Platform

• For the most simple deployment scenarios (e.g. for yourself or your small organization), check our DigitalOcean App Platform configurations and corresponding GitHub Action.

Virtual Instances / Droplets (via SSH)

• Another variant to deploy Gauzy is to use DigitalOcean Droplets or any other virtual instance (with Ubuntu OS) and deploy using SCP/SSH, for example, following GitHub Action

Pulumi

• In addition, check Gauzy Pulumi project (WIP), it makes complex Clouds deployments possible with a single command (pulumi up). Note: it currently supports AWS EKS (Kubernetes) for development and production with Application Load Balancers and AWS RDS Serverless PostgreSQL DB deployments. We also implemented deployments to ECS EC2 and Fargate Clusters in the same Pulumi project.

🚗 Other self-hosting options

Deploy on RepoCloud

Deploy Ever Gauzy instantly with one click on RepoCloud.

💌 Contact Us

• Ever.co Website Contact Us page
• Slack Community
• Discord Chat
• 
• 
• For business inquiries:
• Please report security vulnerabilities to
• Gauzy Platform @ Twitter
• Gauzy Platform @ Facebook

🔐 Security

Ever® Gauzy™ follows good security practices, but 100% security cannot be guaranteed in any software! Ever® Gauzy™ is provided AS IS without any warranty. Use at your own risk! See more details in the LICENSE.

In a production setup, all client-side to server-side (backend, APIs) communications should be encrypted using HTTPS/WSS/SSL (REST APIs, GraphQL endpoint, Socket.io WebSockets, etc.).

If you discover any issue regarding security, please disclose the information responsibly by sending an email to or on and not by creating a GitHub issue.

🛡️ License

We support the open-source community. If you're building awesome non-profit/open-source projects, we're happy to help and will provide (subject to acceptance criteria) Ever Gauzy Enterprise edition license and free hosting option! Feel free to contact us at to make a request. More details are explained in our Wiki.

This software is available under the following licenses:

• Ever® Gauzy™ Platform Community Edition
• Ever® Gauzy™ Platform Small Business
• Ever® Gauzy™ Platform Enterprise

The default Ever® Gauzy™ Platform license, without a valid Ever® Gauzy™ Platform Enterprise or Ever® Gauzy™ Platform Small Business License agreement, is the Ever® Gauzy™ Platform Community Edition License

Please see LICENSE for more information on licenses. You can also compare our offering

™️ Trademarks