https://github.com/migasfree/migasfree-backend
Systems Management System (backend). Provides a REST API.
https://github.com/migasfree/migasfree-backend
django python rest-api
Last synced: 4 months ago
JSON representation
Systems Management System (backend). Provides a REST API.
- Host: GitHub
- URL: https://github.com/migasfree/migasfree-backend
- Owner: migasfree
- License: gpl-3.0
- Created: 2015-03-03T20:52:48.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2026-02-13T10:44:27.000Z (4 months ago)
- Last Synced: 2026-02-13T17:54:14.844Z (4 months ago)
- Topics: django, python, rest-api
- Language: Python
- Homepage:
- Size: 2.64 MB
- Stars: 3
- Watchers: 4
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# migasfree-backend
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://www.python.org/downloads/)
[](https://www.djangoproject.com/)
[](https://github.com/astral-sh/ruff)
**migasfree-backend** is the server component of the **Migasfree Server Suite 5**. It provides a complete REST API for centralized software configuration management across large computer fleets.
## 📚 Documentation
We have comprehensive documentation available in the `docs/` directory:
- **[Getting Started](docs/tutorials/getting-started.md)**: Start here!
- **[Installation](docs/how-to/install-production.md)**: Production setup.
- **[Configuration](docs/reference/configuration.md)**: Settings reference.
- **[Core Concepts](docs/explanation/core-concepts.md)**: How Migasfree works.
- **[API](docs/reference/api.md)**: REST API details.
## ✨ Key Features
- 🔐 **Authentication**: Supports JWT, Session, and Mutual TLS (mTLS) for ultra-secure client communication.
- 📊 **Real-time Dashboard**: Live statistics powered by Redis and WebSockets.
- 🔄 **Scalable Processing**: Asynchronous architecture using Celery to handle thousands of concurrent client syncs.
- 📦 **Extensible PMS**: Modular support for APK, APT, DNF, Pacman, YUM, Zypper, and WPT.
- 🔍 **API Documentation**: Automatic OpenAPI 3.0 schema generation with Swagger UI.
- 🌍 **Internationalization**: Fully translatable (Spanish, English, French, and more).
## 🚀 Getting Started
For a quick local setup, check the **[Getting Started Tutorial](docs/tutorials/getting-started.md)**.
### Quick Install (Users)
```bash
pip3 install migasfree-backend
```
## 🏗️ Architecture Modules
For a detailed deep-dive, read our **[Architecture Explanation](docs/explanation/architecture.md)**.
| Module | Purpose |
| -------------- | --------------------------------------------------------------------------------------- |
| **`client`** | Manages computers (`Computer`), synchronizations (v5), and incident reports. |
| **`core`** | The backbone: projects, deployments, package sets, and properties. |
| **`device`** | Management of peripheral hardware such as drivers and network printers. |
| **`hardware`** | Highly detailed hardware inventory (CPUs, RAM, Disks, Motherboards). |
| **`stats`** | Logic for aggregating and serving historical data for the dashboard. |
| **`api_v4`** | Legacy API layer for backward compatibility with Migasfree Client v4. |
## 📄 License
This project is licensed under the [GNU General Public License v3.0](LICENSE).
## 👥 Authors
- **Alberto Gacías** ([@albertogacias](https://github.com/albertogacias))
- **Jose Antonio Chavarría** ([@jact](https://github.com/jact))
## 🤝 Contributing
We value your help! Check our [Contribution Guidelines](CONTRIBUTING.md) and join our community at [migasfree.org](https://migasfree.org/).
---
- **Repository**: [github.com/migasfree/migasfree-backend](https://github.com/migasfree/migasfree-backend/)
- **Issues**: [Post a bug or feature request](https://github.com/migasfree/migasfree-backend/issues)