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.
- 📝 Create, assign, and track work orders.
- ⏱️ Log time, set priorities, and track history.
- 🤖 Automate work orders with triggers.
- 📊 Export reports and view analytics.
- 💼 Work order compliance and cost analysis.
- 🛠️ Equipment downtime and reliability insights.
- 💵 Cost trends and labor tracking.
- ⚙️ Track equipment, downtime, and maintenance costs.
- 📦 Manage inventory with stock alerts.
- 🛒 Automate purchase orders and approvals.
- 👥 Assign tasks to teams or service providers.
- 🧑💼 Customizable user roles and permissions.
- 🔄 Define workflows with automation logic.
- 📍 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!
git clone https://github.com/grashjs/cmms.git
cd cmmsConfigure 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) |
docker-compose up -dNow, go to http://localhost:3000
Celebrate on how easy this was
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.
- English
- French
- Turkish
Don't want to handle the maintenance and management yourself? We offer a complete done-for-you service. Please reach out to us
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

