{"id":28085745,"url":"https://github.com/codeperfectplus/systemguard","last_synced_at":"2025-05-13T10:41:54.086Z","repository":{"id":254589582,"uuid":"846065574","full_name":"codeperfectplus/SystemGuard","owner":"codeperfectplus","description":"Lightweight, user-friendly, and easy-to-set-up server monitoring GUI tool","archived":false,"fork":false,"pushed_at":"2024-11-09T09:19:33.000Z","size":3312,"stargazers_count":12,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2025-05-11T20:09:58.304Z","etag":null,"topics":["cpu-monitoring","gpu-monitoring","memory-monitoring","monitoring-server","monitoring-tool","network-programming","network-security","security","security-audit","security-tools","server-monitoring","server-monitoring-system"],"latest_commit_sha":null,"homepage":"https://systemguard.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codeperfectplus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security_analysis.rst","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-22T13:16:37.000Z","updated_at":"2024-12-18T22:46:17.000Z","dependencies_parsed_at":"2024-09-05T14:07:10.953Z","dependency_job_id":"f18b52b3-aea3-4c97-b22b-faf8bab19950","html_url":"https://github.com/codeperfectplus/SystemGuard","commit_stats":null,"previous_names":["codeperfectplus/systemdashboard","codeperfectplus/systemguard"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FSystemGuard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FSystemGuard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FSystemGuard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FSystemGuard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeperfectplus","download_url":"https://codeload.github.com/codeperfectplus/SystemGuard/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253925689,"owners_count":21985369,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpu-monitoring","gpu-monitoring","memory-monitoring","monitoring-server","monitoring-tool","network-programming","network-security","security","security-audit","security-tools","server-monitoring","server-monitoring-system"],"created_at":"2025-05-13T10:41:53.332Z","updated_at":"2025-05-13T10:41:54.055Z","avatar_url":"https://github.com/codeperfectplus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SystemGuard 💂\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://systemguard.readthedocs.io/en/latest/?badge=latest\"\u003e\n          \u003cimg src=\"https://readthedocs.org/projects/systemguard/badge/?version=latest\" alt=\"Documentation Status\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/blob/main/LICENSE\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/license/codeperfectplus/SystemGuard\" alt=\"GitHub license\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/releases\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/v/release/codeperfectplus/SystemGuard\" alt=\"GitHub release\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/issues\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/issues/codeperfectplus/SystemGuard\" alt=\"GitHub issues\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/pulls\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/issues-pr/codeperfectplus/SystemGuard\" alt=\"GitHub pull requests\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/commits/dev\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/commit-activity/m/codeperfectplus/SystemGuard\" alt=\"GitHub commit activity\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/network/members\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/forks/codeperfectplus/SystemGuard\" alt=\"GitHub forks\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/stargazers\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/stars/codeperfectplus/SystemGuard\" alt=\"GitHub stars\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/codeperfectplus/SystemGuard/watchers\"\u003e\n          \u003cimg src=\"https://img.shields.io/github/watchers/codeperfectplus/SystemGuard\" alt=\"GitHub watchers\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\nSystem Guard is a Flask app designed to monitor server stats such as CPU, Memory, Disk, and Network. It also provides real-time monitoring capabilities which can be useful for system administrators, developers, and DevOps engineers to keep track of their server's performance and troubleshoot issues. The app uses the `psutil` library to retrieve system stats and the `speedtest-cli` library to perform a network speed test.\n\n\n## Features 🚀\n\n- Lightweight, open-source, and free to use with a straightforward installation process, out-of-the-box monitoring solution.\n- Capable of monitoring core server metrics like CPU, memory, disk usage, and network traffic.\n- Analyze fluctuations in server performance with historical data displayed as charts.\n- Centralized control panel for monitor/manage/analyze the fleet of servers.\n- Role-Based Access Control (RBAC) for managing user permissions.\n- Includes built-in security features such as authentication for login, logout, and signup.\n- Analuze the network speed with the built-in speed test feature.\n- Anaylze the suspicious processes and terminate them with a single click.\n- Anaylze the network statistics with the built-in network statistics feature.\n- Anaylze the subnet for security vulnerabilities with the built-in security analysis feature.\n- Option to download historical data in CSV format for detailed analysis (upcoming feature).\n- Role-based dashboards tailored for Developer, Admin, IT Manager, and Manager roles (upcoming feature).\n- Update security updates with a single click or automatically update to the latest version to simplify maintenance.\n\n## Get started 🛠️\n\n- Check the [documentation](https://systemguard.readthedocs.io/en/latest/installation.html) for installation instructions.\n\n## Architecture 🏗️\n\n![SystemGuard-Architecture](docs/assets/images/architecture.jpg)\n\n## Tech Stack 🛠️\n\n- **Frontend**: JavaScript, Bootstrap, Chart.js, Grafana\n- **Backend**: Python, Flask, SQLAlchemy, SQLite, Prometheus, InfluxDB\n- **Monitoring**: psutil, speedtest-cli, nmap, netstat\n\n## Release Notes 📝\n\n- Check the [Release Notes](/src/docs/Release.md) file for the latest updates.\n- Check the [Release Instructions](/src/docs/release_instrunctions.md) file for the release process.\n\n## Supported Systems 🖥️\n\n- Most Linux distributions are supported, including Ubuntu, CentOS, and Debian.\n\n## How does installation work? 🤔\n\nThe installation process is straightforward and can be completed in a few steps. The user needs to run a bash script that installs the required dependencies, sets up the database, create a conda environment, and add flask server to the cron job. The user can then access the SystemGuard web interface by visiting the server's IP address or domain name.\n\n## Product Screenshots 📸\n\nCheck the product [screenshots](/src/docs/README.md) for a visual representation of the app.\n\n## Why not use a Docker image? 🐳\n\nA Docker image has not been created for this project because it requires access to the host machine in order to retrieve server stats. Therefore, it is not possible to obtain server stats from within a Docker container.\n\n## Contributing 🤝\n\nContributions are always welcome! Please read the [contribution guidelines](/CONTRIBUTING.md) first.\n\n## License 📝\n\nThis project is licensed under the MIT License - see the [LICENSE](/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeperfectplus%2Fsystemguard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeperfectplus%2Fsystemguard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeperfectplus%2Fsystemguard/lists"}