{"id":30749776,"url":"https://github.com/ozturkeniss/mini-linux-sysmng","last_synced_at":"2025-10-10T05:43:57.778Z","repository":{"id":310729982,"uuid":"1041009366","full_name":"ozturkeniss/mini-linux-sysmng","owner":"ozturkeniss","description":"Modular bash-based system administration tool designed to provide essential Linux system management capabilities through an intuitive menu-driven interface.","archived":false,"fork":false,"pushed_at":"2025-08-19T21:00:52.000Z","size":50,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-19T23:17:47.295Z","etag":null,"topics":["bash-script","basic-linux-commands","linux","linux-kernel","linux-shell","scripting"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ozturkeniss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-19T20:59:03.000Z","updated_at":"2025-08-19T21:01:52.000Z","dependencies_parsed_at":"2025-08-19T23:27:49.649Z","dependency_job_id":null,"html_url":"https://github.com/ozturkeniss/mini-linux-sysmng","commit_stats":null,"previous_names":["ozturkeniss/mini-linux-sysmng"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ozturkeniss/mini-linux-sysmng","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozturkeniss%2Fmini-linux-sysmng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozturkeniss%2Fmini-linux-sysmng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozturkeniss%2Fmini-linux-sysmng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozturkeniss%2Fmini-linux-sysmng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ozturkeniss","download_url":"https://codeload.github.com/ozturkeniss/mini-linux-sysmng/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozturkeniss%2Fmini-linux-sysmng/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273567620,"owners_count":25128631,"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","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bash-script","basic-linux-commands","linux","linux-kernel","linux-shell","scripting"],"created_at":"2025-09-04T06:46:26.078Z","updated_at":"2025-10-10T05:43:52.733Z","avatar_url":"https://github.com/ozturkeniss.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mini Linux System Management Tool\n\nA comprehensive, modular bash-based system administration tool designed to provide essential Linux system management capabilities through an intuitive menu-driven interface.\n\n## Overview\n\nThe Mini Linux System Management Tool is a collection of bash scripts organized in a modular architecture that enables system administrators and users to perform common Linux system management tasks without memorizing complex command-line syntax.\n\n## Features\n\n### System Management\n- **System Status**: Real-time CPU, RAM, disk usage, and system information\n- **Disk Management**: Disk space analysis, inode usage, and S.M.A.R.T. health monitoring\n- **Performance Monitoring**: System resource utilization and performance metrics\n\n### User Management\n- **User Operations**: Add, modify, and manage system users and groups\n- **User Information**: Comprehensive user listing with detailed information\n- **Access Control**: User permission management and security settings\n\n### Service Management\n- **Service Status**: Monitor and manage system services (systemd/SysV init)\n- **Service Control**: Start, stop, restart, and enable/disable services\n- **Service Statistics**: Service performance and status reporting\n\n### Package Management\n- **Multi-Distribution Support**: Compatible with apt, dnf, yum, pacman, zypper, and emerge\n- **Package Installation**: Install packages with dependency resolution\n- **Package Search**: Find and install packages from repositories\n\n### Network Management\n- **Network Status**: Interface information, IP addresses, and network configuration\n- **Network Diagnostics**: Port scanning, connectivity testing, and traffic analysis\n- **Network Tools**: Advanced network troubleshooting utilities\n\n### File System Management\n- **File Explorer**: Interactive file system navigation and management\n- **File Operations**: Copy, move, delete, and modify files and directories\n- **Permission Management**: File and directory permission control\n\n### Backup and Recovery\n- **Backup Creation**: Directory, configuration, and full system backups\n- **Backup Restoration**: Restore backups with validation and safety checks\n- **Backup Management**: Backup scheduling, cleanup, and monitoring\n\n### Log Management\n- **System Logs**: View and analyze system logs from journalctl and /var/log\n- **Log Monitoring**: Real-time log monitoring and filtering\n- **Log Maintenance**: Log rotation and cleanup utilities\n\n### Configuration Management\n- **Tool Configuration**: Centralized configuration management\n- **Theme System**: Customizable user interface themes\n- **Settings Management**: Persistent configuration storage\n\n## Architecture\n\n### Modular Design\nThe tool follows a modular architecture where each functionality is implemented as a separate script:\n\n```\nmini-linux-sysmng/\n├── mini-sysmgmt.sh          # Main application entry point\n├── modules/                  # Functional modules\n│   ├── system/              # System management modules\n│   ├── users/               # User management modules\n│   ├── services/            # Service management modules\n│   ├── packages/            # Package management modules\n│   ├── network/             # Network management modules\n│   ├── files/               # File system modules\n│   ├── logs/                # Log management modules\n│   ├── backup/              # Backup and recovery modules\n│   └── tools/               # Utility and configuration modules\n├── themes/                   # User interface themes\n├── config/                   # Configuration files\n├── scripts/                  # Installation and maintenance scripts\n└── docs/                     # Documentation\n```\n\n### Theme System\nThe tool includes a comprehensive theming system that provides:\n- Consistent color schemes across all modules\n- Customizable user interface elements\n- Professional appearance and readability\n\n## Requirements\n\n### System Requirements\n- **Operating System**: Linux (Ubuntu, Debian, CentOS, RHEL, Fedora, Arch Linux, openSUSE, Gentoo)\n- **Shell**: Bash 4.0 or higher\n- **Architecture**: x86_64, ARM64, or compatible\n\n### Dependencies\n- **Core Utilities**: Standard GNU/Linux utilities (ls, find, grep, awk, sed)\n- **System Tools**: htop, tree, curl, wget (installed automatically)\n- **Network Tools**: net-tools, iproute2\n- **Package Managers**: Distribution-specific package managers\n\n## Installation\n\n### Quick Installation\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/mini-linux-sysmng.git\ncd mini-linux-sysmng\n\n# Run the installation script\nsudo ./scripts/install.sh\n\n# Start the tool\n./mini-sysmgmt.sh\n```\n\n### Manual Installation\n```bash\n# Make scripts executable\nchmod +x mini-sysmgmt.sh\nchmod +x scripts/*.sh\nchmod +x modules/*/*.sh\n\n# Install dependencies manually\nsudo apt update\nsudo apt install htop tree curl wget git net-tools\n```\n\n## Usage\n\n### Starting the Tool\n```bash\n./mini-sysmgmt.sh\n```\n\n### Main Menu Navigation\nThe tool provides a comprehensive menu system with 35 options organized into logical categories:\n\n1. **System Management** (Options 1-5)\n2. **User Management** (Options 6-9)\n3. **Service Management** (Options 10-13)\n4. **Package Management** (Options 14-17)\n5. **Network Management** (Options 18-21)\n6. **File Management** (Options 22-25)\n7. **Log Management** (Options 26-29)\n8. **Backup Management** (Options 30-32)\n9. **Tool Configuration** (Options 33-35)\n\n### Module Usage\nEach module provides its own submenu and functionality. Users can navigate through options using numeric input and return to the main menu at any time.\n\n## Configuration\n\n### Configuration Files\n- **`config/sysmgmt.conf`**: Main configuration file\n- **`config/themes.conf`**: Theme configuration\n- **`config/shortcuts.conf`**: Quick access shortcuts\n\n### Customization\nThe tool can be customized through:\n- Configuration file modifications\n- Theme customization\n- Module addition and modification\n\n## Security\n\n### Root Privileges\nCertain operations require root privileges for security reasons:\n- User management operations\n- Service management\n- System configuration changes\n- Backup and restoration operations\n\n### Safety Features\n- Confirmation prompts for destructive operations\n- Input validation and sanitization\n- Error handling and logging\n- Backup verification\n\n## Development\n\n### Adding New Modules\nTo add new functionality:\n\n1. Create a new script in the appropriate module directory\n2. Implement the required functions\n3. Include the theme system for consistent appearance\n4. Add menu integration in the main script\n5. Test thoroughly before deployment\n\n### Module Structure\nEach module should:\n- Source the theme file for consistent appearance\n- Include proper error handling\n- Provide clear user feedback\n- Follow the established naming conventions\n\n### Testing\n- Test modules individually\n- Verify integration with the main system\n- Check error handling and edge cases\n- Validate user experience and interface consistency\n\n## Troubleshooting\n\n### Common Issues\n- **Permission Denied**: Ensure scripts have execute permissions\n- **Module Not Found**: Check module file paths and permissions\n- **Theme Errors**: Verify theme file existence and syntax\n- **Dependency Issues**: Install required system packages\n\n### Debug Mode\nEnable debug output by setting the DEBUG environment variable:\n```bash\nDEBUG=1 ./mini-sysmgmt.sh\n```\n\n### Log Files\nCheck system logs for detailed error information:\n```bash\njournalctl -u your-service\ntail -f /var/log/syslog\n```\n\n## Contributing\n\n### Development Guidelines\n- Follow bash scripting best practices\n- Maintain consistent code style\n- Include comprehensive error handling\n- Document all functions and features\n- Test thoroughly on multiple distributions\n\n### Code Review Process\n1. Submit pull requests with detailed descriptions\n2. Ensure all tests pass\n3. Follow the established coding standards\n4. Include appropriate documentation updates\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Support\n\n### Documentation\n- Comprehensive inline documentation\n- Module-specific help systems\n- Configuration examples\n- Troubleshooting guides\n\n### Community\n- GitHub Issues for bug reports\n- Discussion forums for questions\n- Wiki for additional documentation\n- Contributing guidelines for developers\n\n## Version History\n\n### Current Version: 1.0.0\n- Initial release with core functionality\n- Modular architecture implementation\n- Theme system integration\n- Multi-distribution package management support\n\n### Planned Features\n- Web-based interface\n- API integration capabilities\n- Advanced monitoring and alerting\n- Cloud deployment support\n- Container management integration\n\n## Acknowledgments\n\n- Linux community for inspiration and best practices\n- Bash scripting community for technical guidance\n- Open source contributors for continuous improvement\n- System administrators for feature requests and feedback\n\n---\n\n**Note**: This tool is designed for educational and professional use. Always test in a safe environment before using in production systems.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozturkeniss%2Fmini-linux-sysmng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fozturkeniss%2Fmini-linux-sysmng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozturkeniss%2Fmini-linux-sysmng/lists"}