Repolode
Submit
Grashjs

Grashjs/cmms

Self-hosted computerized maintenance management system (CMMS) with web and mobile apps for work orders, assets and inventory.

Open-source alternative to:UpKeepFiix

View on GitHubWebsite
Stars
861
Forks
250
Open issues
96
Last commit
2 days ago

What is it?

Atlas CMMS is a self-hosted maintenance management system for tracking work orders, equipment, and maintenance activities. It runs on Docker and includes a web interface plus Android and iOS mobile apps that connect to your own backend server. It is aimed at facility managers, manufacturing teams, and other organizations that need to keep equipment running and coordinate technicians.

The system covers work order creation, assignment, and history, along with equipment downtime and cost tracking, inventory with stock alerts, and purchase order approvals. Locations and service requests can be managed with Google Maps integration, and user roles and permissions are customizable.

The backend is built on Java Spring Boot, the web frontend on React and TypeScript, and the mobile app on React Native. Storage can use MinIO or Google Cloud Storage, and login supports SSO through Google or Microsoft as well as LDAP. The core project is licensed under AGPLv3, with a commercial license for white labeling and advanced features.

Key features

  • 01Create, assign, and track work orders with priorities and history.
  • 02Track equipment downtime, maintenance costs, and labor.
  • 03Manage inventory with stock alerts and automate purchase orders.
  • 04Customizable user roles, permissions, and workflow automation.
  • 05Manage locations with Google Maps and handle service requests.
  • 06Runs via Docker Compose with Android and iOS companion apps.

Use cases

  • Managing preventive maintenance for buildings, campuses, or hotels.
  • Tracking machinery and medical equipment repairs in manufacturing or healthcare.
  • Coordinating technicians and outside service providers on work orders.
  • Running an in-house maintenance system without sending asset data to a SaaS vendor.

Quick start

  1. 1

    Download docker-compose.yml, nginx.conf and .env.example, then rename .env.example to .env

  2. 2

    Start the services with Docker Compose

    docker-compose up -d
  3. 3

    Open http://localhost:3000 in your browser

Things to know

  • Requires Docker and manual setup of several environment variables, including a JWT secret.
  • Some advanced features need a paid Atlas CMMS license key.
  • Email notifications, SSO and Google Maps features need extra configuration with third-party services.

In collections

Self-hosted apps

Topics

#cmms#maintenance-management#self-hosted#asset-management#inventory-management#work-orders#docker#react-native#asset-tracking#equipment-maintenance

FAQ

What is cmms?
Self-hosted computerized maintenance management system (CMMS) with web and mobile apps for work orders, assets and inventory. Atlas CMMS is a self-hosted maintenance management system for tracking work orders, equipment, and maintenance activities. It runs on Docker and includes a web interface plus Android and iOS mobile apps that connect to your own backend server. It is aimed at facility managers, manufacturing teams, and other organizations that need to keep equipment running and coordinate technicians.
Is cmms free to use? What license does it have?
cmms is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is cmms still maintained?
Actively maintained. The last commit to cmms was on Nov 5, 2026.
What can I use cmms for?
Managing preventive maintenance for buildings, campuses, or hotels. Tracking machinery and medical equipment repairs in manufacturing or healthcare. Coordinating technicians and outside service providers on work orders. Running an in-house maintenance system without sending asset data to a SaaS vendor.
How do I install cmms?
Download docker-compose.yml, nginx.conf and .env.example, then rename .env.example to .env Start the services with Docker Compose: docker-compose up -d Open http://localhost:3000 in your browser
Where can I get cmms?
The source code and installation instructions are on GitHub: https://github.com/Grashjs/cmms

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects