Where sysadmins unlock the ultimate power of configurations
held together by duct tape and optimism.
IamRoot is a personal and shared toolbox for Linux sysadmins.
It is a collection of:
- Useful scripts for day-to-day admin work
- Inventory and audit helpers
- Diagnostics and troubleshooting tools
- Cheat sheets and snippets you actually look up
- Documentation that explains things without assuming too much
This repo exists because real systems are messy and understanding them should not be.
The main idea is simple:
- Make systems easier to understand
- Prefer inspection over modification
- Produce output that humans can read
- Turn command-line knowledge into documentation
Many scripts here are designed to generate information that can later be turned into internal documentation or PDFs. Nothing fancy, just useful.
- Not a framework
- Not a config management system
- Not opinionated about your infrastructure
- Not trying to automate everything
If something is clever but hard to understand, it probably does not belong here.
This repo is split into a few top-level directories like:
- docs
- scripts
- snippets
- configs
- cheat-sheets
- archive
Each directory has its own README that explains what belongs there.
The main README stays high-level on purpose.
If you are unsure where something should go, check the README in that directory first.
In general:
- Scripts are organized by domain: system, networking, security, utils
- Snippets are short examples or reminders
- Cheat sheets are quick references
- Archive is where old or replaced things go
If you are unsure where a script belongs, pick the domain closest to its purpose.
Most scripts here are read-only by default. If something is destructive, it should be obvious and clearly documented.
This repo favors:
- clarity over speed
- boring solutions over clever ones
- commands you can explain to someone else
- Linux sysadmins
- Research IT and lab support
- Anyone maintaining systems they did not set up themselves
- People who want fewer surprises at 3 AM
It works best in Ubuntu and Debian environments, but nothing should be tightly coupled to one setup.
If you want to add or change something, please read:
- CONTRIBUTING.md
Short version:
- Follow the existing structure
- Write things so future you understands them
- Prefer simple and readable
- Use conventional commits
- Avoid destructive defaults
This repo is about understanding systems, not pretending they are perfect.
If a script helped you answer
"what is actually going on here?"
then it probably belongs in IamRoot.