Skip to content
 
 

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Atlas CMMS

Atlas CMMS is a robust, free self hosted (web-mobile) based Maintenance management tool using Docker. It is designed to streamline work order management, preventive maintenance, asset tracking, and team collaboration.

Screenshot:

Features

Work Orders & Maintenance

  • 📝 Create, assign, and track work orders.
  • ⏱️ Log time, set priorities, and track history.
  • 🤖 Automate work orders with triggers.
  • 📊 Export reports and view analytics.

Analytics & Reporting

  • 💼 Work order compliance and cost analysis.
  • 🛠️ Equipment downtime and reliability insights.
  • 💵 Cost trends and labor tracking.

Equipment & Inventory

  • ⚙️ Track equipment, downtime, and maintenance costs.
  • 📦 Manage inventory with stock alerts.
  • 🛒 Automate purchase orders and approvals.

User & Workflow Management

  • 👥 Assign tasks to teams or service providers.
  • 🧑‍💼 Customizable user roles and permissions.
  • 🔄 Define workflows with automation logic.

Locations & Requests

  • 📍 Manage locations with Google Maps integration.
  • 📑 Create and track service requests.

You can check out the complete list of features.

We'd love to have new contributors, so feel free to join us!
Star this repo to support us!

Self Host

Clone the Repository

git clone https://github.com/grashjs/cmms.git
cd cmms

Set environment variables

Configure the environment variables in this file .env At the moment all variables are optional. Do not delete the .env file

Name Required Description Default Value
SMTP_PWD No The SMTP password after creating an app password with Google. Learn how to create an app password. To be able to invite people you have to configure it. (empty)
SMTP_USER No The SMTP username after creating an app password with Google. Learn how to create an app password (empty)
JWT_SECRET_KEY No JWT secret key your_jwt_secret
REACT_APP_GOOGLE_KEY No Google Maps API key (empty)
REACT_APP_GOOGLE_TRACKING_ID No Google Analytics tracking ID (empty)
FASTSPRING_PWD No FastSpring password. Fastspring is a payment gateway (empty)
FASTSPRING_USER No FastSpring username (empty)
FRONT_URL No Frontend URL http://localhost:3000
REACT_APP_API_URL No Backend API URL http://localhost:8080/
SPRING_PROFILES_ACTIVE No Active Spring profile(s) (empty)
GCP_JSON No The Google Cloud JSON key after following these instructions. (empty)
GCP_PROJECT_ID No The Google Cloud project ID, also found in the GCP_JSON file. (empty)
GCP_BUCKET_NAME No GCP Bucket Name (empty)
MAIL_RECIPIENTS No Comma-separated email addresses of the super admins where to send information emails like new signups. You can provide your email address. (empty)

Run

docker-compose up -d

Now, go to http://localhost:3000

Celebrate on how easy this was

Getting help

You can first go to https://grashjs.github.io/user-guide. If you still have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker or send an email at ibracool99@gmail.com.

Supported languages

  • English
  • French
  • Turkish

🏗️ Tech Stack

  • Api with java Spring Boot
  • Website with React/Typescript
  • Mobile with React Native.

Need Professional Help?

Don't want to handle the maintenance and management yourself? We offer a complete done-for-you service. Please reach out to us

🤝 Looking to contribute?

We welcome contributions! You can help by:

  • ✅ Reporting bugs
  • ✅ Suggesting new features
  • ✅ Improving documentation
  • ✅ Submitting pull requests

Check CONTRIBUTING.md inside each subproject for details.

You can also join our Discord server

Open source licensing info

  1. LICENSE

About

#1 Self hosted CMMS web & mobile application that allows you to manage maintenance for free

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages