<p align="center"><img src="frontend/public/static/images/logo/logo.png" width="80"></p> <h1 align="center">Atlas CMMS</h1>

Atlas CMMS is a powerful, self-hosted maintenance management system designed for both web and mobile platforms using Docker. It simplifies and automates the management of maintenance activities, making it ideal for IT managers or developers looking to implement solutions that keep their organization's assets running smoothly. Think of it like Jira for technicians.

Example industries

Facilities Managers (buildings, property, real estate)
Manufacturing/Production Teams (machinery and equipment)
Healthcare Facilities (medical equipment maintenance)
Hospitality Managers (hotels and resorts)
Public Sector (infrastructure and public buildings)
Educational Institutions (campus maintenance)
Utility Companies (power, water, and energy systems)

Demo website

https://atlas-cmms.com

Screenshots:

⚡ 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 / Run locally

⚡ Quick Start (2 minutes)

Download:

docker-compose.yml
.env.example → rename to .env

Run:
```
docker-compose up -d
```

Go to http://localhost:3000 to access Atlas CMMS.

Need customization or production setup? Continue reading below ↓

Set environment variables

| Name |-----------------------------|--- | POSTGRES_USER | POSTGRES_PWD | MINIO_USER | MINIO_PWD | JWT_SECRET_KEY | ENABLE_EMAIL_NOTIFICATIONS | No | INVITATION_VIA_EMAIL | No | MAIL_TYPE | No | SMTP_HOST | No | SMTP_PORT | No | SMTP_USER | No | SMTP_PWD | No | SENDGRID_API_KEY | No | SENDGRID_FROM_EMAIL | No | ENABLE_CORS | No | ALLOWED_ORGANIZATION_ADMINS | No | GOOGLE_KEY | No | GOOGLE_TRACKING_ID | No | Required | Description | Default Value | -------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------| | Yes | Postgres user | rootUser | | Yes | Postgres password | mypassword | | Yes | MiniO user | minio | | Yes | MiniO password | minio123 | | Yes | JWT secret key. Generate with openssl rand -base64 32 | your_jwt_secret | | Enables or disables email notifications (true or false). Requires SMTP if enabled. | false | | Enables or disables user invitations via email (true or false). Requires SMTP and ENABLE_EMAIL_NOTIFICATIONS if enabled. | false | | Mail type: SMTP or SENDGRID | smtp | | The SMTP host | smtp.gmail.com | | The SMTP port | 587 | | The SMTP username. If using Gmail, Learn how to create an app password | (empty) | | The SMTP password. If using Gmail, Learn how to create an app password | (empty) | | The Sendgrid API key | (empty) | | The Sendgrid sender email | (empty) | | Enables or disables CORS security feature. Recommended to enable it | false | | Comma separated email addresses allowed to sign up without being invited, hence allowed to create organizations. Empty means everyone can create an organization | (empty) | | Google Maps API key | (empty) | | Google Analytics tracking ID | (empty) |

Cmms

Install / Use

README