A personal, practical reference for Linux administration, infrastructure, and DevOps workflows. Step-by-step guides, real-world configs, and ready-to-use scripts — organized by topic so you can jump straight to what you need.
Philosophy: minimal theory, maximum application. Copy-paste friendly, tested in real environments.
git clone https://github.com/RadinPirouz/devops-documents.git
cd devops-documents- Pick a category below (or open its
README.mdfor a detailed index). - Read the
.mdguides or inspect configs/scripts before running anything. - Adjust variables (hostnames, paths, credentials) to match your environment.
Most guides are tested on Debian/Ubuntu and CentOS/RHEL. Always review configs and test in staging before production.
devops-documents/
├── Linux/ # OS admin, bash, cron, rsync
├── Code/ # Git, GitLab CI/CD
├── Networking/ # DNS, firewall, scanning, SMB
├── Web/ # Nginx, HAProxy, Certbot, Nextcloud
├── Containers/ # Docker, Kubernetes, Dozzle
├── Automation/ # Ansible
├── Databases/ # MySQL, MariaDB, PostgreSQL, Redis
├── Storage/ # MinIO, NFS, S5CMD
├── Monitoring/ # ELK, Zabbix, Netdata, LibreNMS
├── Cloud/ # AWS, Vagrant
├── Applications/ # Jitsi, Vaultwarden
└── System/ # Kernel compile
Each top-level folder has its own README.md with sub-topics, learning paths, and direct links to every guide.
Sections follow a typical workflow: foundation → networking → platform → data → delivery → operations.
| # | Category | What's inside | Index |
|---|---|---|---|
| 1 | Linux | Administration, bash, cron, rsync, screen | Linux/README.md |
| 2 | Code | Git, GitLab install & CI/CD | Code/README.md |
| 3 | Networking | BIND9, iptables, nmap, tcpdump, SMB | Networking/README.md |
| 4 | Web | Nginx, HAProxy, Certbot, Nextcloud | Web/README.md |
| 5 | Containers | Docker, Kubernetes, Dozzle | Containers/README.md |
| 6 | Automation | Ansible playbooks & roles | Automation/README.md |
| 7 | Databases | MySQL, MariaDB, PostgreSQL, Redis | Databases/README.md |
| 8 | Storage | MinIO, NFS, S5CMD | Storage/README.md |
| 9 | Monitoring | ELK, Zabbix, Netdata, LibreNMS | Monitoring/README.md |
| 10 | Cloud | AWS, Vagrant | Cloud/README.md |
| 11 | Applications | Jitsi, Vaultwarden | Applications/README.md |
| 12 | System | Kernel management | System/README.md |
| Topic | Path |
|---|---|
| Linux basics | Linux/administration/ |
| Bash scripting | Linux/bash/ |
| Cron jobs | Linux/cron/ |
| Git | Code/git/ |
| GitLab CI/CD | Code/gitlab/ci/ |
| DNS (BIND9) | Networking/bind9/ |
| Firewall (iptables) | Networking/iptables/ |
| Nginx | Web/nginx/ |
| HAProxy | Web/haproxy/ |
| Docker | Containers/docker/ |
| Kubernetes workloads | Containers/kubernetes/workloads/ |
| Ansible | Automation/ansible/ |
| MySQL / MariaDB / PostgreSQL | Databases/ |
| Redis | Databases/redis/ |
| MinIO | Storage/minio/ |
| ELK / Zabbix | Monitoring/elk/, Monitoring/zabbix/ |
| AWS | Cloud/aws/ |
| Vagrant | Cloud/vagrant/ |
| Jitsi | Applications/jitsi/ |
| Vaultwarden | Applications/vaultwarden/ |
| Kernel compile | System/kernel/ |
Every topic folder typically includes:
- Step-by-step setup and operation guides
- Configuration examples you can adapt
- Scripts and manifests for real deployments
Sections are self-contained — start anywhere based on what you're working on.
Suggested entry points:
| If you need to… | Start here |
|---|---|
| Learn Linux basics | Linux/administration/ |
| Set up a web server | Web/nginx/ |
| Run containers | Containers/docker/ |
| Deploy to Kubernetes | Containers/kubernetes/ |
| Automate with Ansible | Automation/ansible/ |
Contributions are welcome. If you have a useful script, a better config, or a new guide:
git checkout -b feature/your-feature
# make your changes
git commit -m "Add: your feature"
git push origin feature/your-featureThen open a Pull Request on GitHub.
Naming conventions for new docs:
- Top-level categories use
PascalCase(e.g.Linux/,Containers/) - Sub-folders use
lowercase-kebab(e.g.nginx/,file-sharing/) - Sequential guides use numbered prefixes (
01-,02-, …)
- GitHub: RadinPirouz
- Telegram: @RadinPirouz
- Issues: devops-documents/issues
If this repo helped you, consider starring it and sharing it with others.