Skip to content

Yoseph-GL/ubuntu-ops-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ubuntu Ops Toolkit

Lightweight, modular Bash utilities for Ubuntu/Debian operations. KISS principles: small scripts, clear output, predictable behavior.

Safety Model

  • Every script supports -h / --help.
  • Read-only scripts default to preview mode.
  • Destructive scripts require --run and interactive confirmation (or --yes).
  • Standard Linux locations only ($HOME, $XDG_*, /tmp, /var/log, /etc).
  • Strict mode enabled everywhere (set -euo pipefail).

Structure

ubuntu-ops-toolkit/
├── docker/
│   ├── docker-clean-safe
│   └── docker-net-audit.sh
├── system/
│   ├── check-logs.sh
│   ├── disk-clean-safe
│   └── health-check
├── network/
│   └── net-debug
├── maintenance/
│   ├── lint-scripts
│   ├── maintenance-all
│   └── update-all
├── LICENSE
└── README.md

Quickstart

git clone https://github.com/Yoseph-GL/ubuntu-ops-toolkit.git ~/ubuntu-ops-toolkit
cd ~/ubuntu-ops-toolkit
chmod +x docker/* system/* network/* maintenance/*

Add to ~/.bashrc or ~/.zshrc:

export UBUNTU_OPS_TOOLKIT="$HOME/ubuntu-ops-toolkit"
export PATH="$UBUNTU_OPS_TOOLKIT/docker:$UBUNTU_OPS_TOOLKIT/system:$UBUNTU_OPS_TOOLKIT/network:$UBUNTU_OPS_TOOLKIT/maintenance:$PATH"

Reload and verify:

source ~/.bashrc   # or source ~/.zshrc
health-check --help
docker-clean-safe --help
maintenance-all --help

Usage

Docker

docker-clean-safe
docker-clean-safe --run
docker-clean-safe --run --with-volumes
docker-net-audit.sh --run

System

health-check --run
check-logs.sh --run
disk-clean-safe
disk-clean-safe --run --days 30
disk-clean-safe --run --deep-system-clean

Network

net-debug --run
net-debug --run --host github.com

Maintenance

update-all
update-all --run
maintenance-all --run --days 21
lint-scripts --run