{"id":25197835,"url":"https://github.com/alexmllo/sysadmin-helper","last_synced_at":"2026-05-03T12:39:41.849Z","repository":{"id":275997270,"uuid":"927873583","full_name":"alexmllo/sysadmin-helper","owner":"alexmllo","description":"Basic CLI tool for Linux System Manager","archived":false,"fork":false,"pushed_at":"2025-02-05T17:31:02.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-03T13:53:21.451Z","etag":null,"topics":["bash","linux","shell"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexmllo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-02-05T17:25:22.000Z","updated_at":"2025-02-05T17:31:25.000Z","dependencies_parsed_at":"2025-02-05T18:47:00.666Z","dependency_job_id":null,"html_url":"https://github.com/alexmllo/sysadmin-helper","commit_stats":null,"previous_names":["alexmllo/sysadmin-helper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alexmllo/sysadmin-helper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmllo%2Fsysadmin-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmllo%2Fsysadmin-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmllo%2Fsysadmin-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmllo%2Fsysadmin-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexmllo","download_url":"https://codeload.github.com/alexmllo/sysadmin-helper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmllo%2Fsysadmin-helper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32569714,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","linux","shell"],"created_at":"2025-02-10T02:19:57.163Z","updated_at":"2026-05-03T12:39:41.830Z","avatar_url":"https://github.com/alexmllo.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sysadmin-helper\n\n## Overview\n\n**sysadmin-helper** is a CLI tool written in Bash for Linux system maintenance. It provides functions for:\n- **Monitoring:** Checking CPU, memory, and disk usage.\n- **Logs:** Rotating and analyzing log files.\n- **Backup:** Creating and restoring backups of important directories.\n- **Maintenance:** Performing system updates and cleaning up temporary files.\n\n## Setup\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/alexmllo/sysadmin-helper.git\n   cd sysadmin-helper\n   ```\n\n2. **Make the main script executable:**\n   ```bash\n   chmod +x bin/sysadmin-helper.sh\n   ```\n3. **Configure your environment:**\n\n   Edit `conf/sysadmin-helper.conf` to set your desired thresholds, log file locations, backup directories, and package manager.\n\n4. **Run the help command:**\n   ```bash\n   ./bin/sysadmin-helper.sh help\n   ```\n## Usage\nUse one of the subcommands to execute a specific task:\n\n### Monitor System Health\nDisplay CPU, memory, and disk usage metrics:\n   ```bash\n   ./bin/sysadmin-helper.sh monitor\n   ```\n\n### Manage Logs\n- __Rotate Logs:__\nRotate and compress the log file:\n   ```bash\n   ./bin/sysadmin-helper.sh logs rotate\n   ```\n\n- __Analyze Logs:__\nAnalyze the log file for errors:\n   ```bash\n   ./bin/sysadmin-helper.sh logs analyze\n   ```\n\n### Backup Operations\n- __Create a Backup:__\nCreate a backup of the directories specified in the configuration:\n   ```bash\n   ./bin/sysadmin-helper.sh backup create\n   ```\n\n- __Restore a Backup:__\nRestore from a specified backup file to a destination (default is root):\n   ```bash\n   ./bin/sysadmin-helper.sh backup restore /path/to/backup.tar.gz /destination/path\n   ```\n\n### Perform Maintenance\nRun routine maintenance tasks such as updating system packages and cleaning temporary files:\n   ```bash\n   ./bin/sysadmin-helper.sh maintain\n   ```\n\nAlternatively, run specific tasks:\n   ```bash\n   ./bin/sysadmin-helper.sh maintain update\n   ./bin/sysadmin-helper.sh maintain cleanup\n   ```\n\n## Configuration\nThe configuration file (`conf/sysadmin-helper.conf`) includes settings such as:\n\n- __Thresholds for Monitoring:__\n   ```bash\n   THRESHOLD_CPU=80\n   THRESHOLD_MEM=80\n   THRESHOLD_DISK=90\n   ```\n\n- __Log File Location:__\n   ```bash\n   LOG_FILE=\"/var/log/sysadmin-helper.log\"\n   ```\n\n- __Backup Settings:__\n   ```bash\n   BACKUP_DIR=\"/tmp/sysadmin-backups\"\n   BACKUP_SOURCES=\"/etc,/var/log\"\n   ```\n\n- __Maintenance Settings:__\nSpecify your package manager (e.g., apt, yum):\n   ```bash\n   PACKAGE_MANAGER=\"apt\"\n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmllo%2Fsysadmin-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexmllo%2Fsysadmin-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmllo%2Fsysadmin-helper/lists"}