Linux-API is a small REST API service for collecting and exposing metrics and user data for Linux systems. It is implemented in Python (FastAPI) and ships with Docker Compose configurations to run the required database services locally.
Full installation and configuration instructions are available in the project's documentation
Please consult the manual setup first for a step-by-step deployment on Ubuntu systems.
- REST API backend built with FastAPI for high performance and async handling
- User & authentication system with permission checks and admin controls
- Metrics & monitoring system for observability and production diagnostics
- Per-route request metrics (counts, response times, percentiles, error rates)
- Status code tracking to detect failures and anomalies
- Global performance statistics for overall system health insights
- TimescaleDB integration for efficient time-series storage and long-term analysis
- Health & monitoring endpoints exposing system status and diagnostics
- Database readiness & migration checks for operational safety
- PostgreSQL connection pooling for performance and reliability
- Rate limiting & security middleware to protect endpoints
- Configurable legacy route support for backward compatibility
- Designed for production observability, debugging, and scalability
- Issues: https://github.com/Ivole32/Linux-API/issues
- Support the project: https://ko-fi.com/ivole32
See the repository root for development notes and tests. If you find problems in the docs or installation steps, please open an issue.
I used ChatGPT to refine devlogs, support structural design decisions, and correct spelling and grammar throughout the documentation.
Made with ❤️ by Ivole32 — https://github.com/Ivole32