Skip to content

itcmsgr/directadmin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

57 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

DirectAdmin Panel Administration Scripts & Tools

Professional automation and monitoring tools for DirectAdmin control panel

License DirectAdmin Production Ready

A comprehensive collection of production-ready scripts, hooks, and automation tools for DirectAdmin Panel system administrators, hosting providers, and infrastructure operators. All tools are designed for enterprise use with proper error handling, logging, and security practices.


πŸ“ Repository Structure

directadmin/
β”œβ”€β”€ scripts/
β”‚      └── dns/               # DNS Change Alert System (NIS2-compliant)
β”œβ”€β”€ docs/                     # Documentations
β”œβ”€β”€ LICENSES/                 # License files
β”œβ”€β”€ LICENSE.txt               # ITCMS Free License
β”œβ”€β”€ SECURITY.md               # Security policy
β”œβ”€β”€ CONTRIBUTING.md           # Contribution guidelines
β”œβ”€β”€ CHANGELOG.md              # Version history
└── README.md                 # This file

πŸš€ Available Tools

🌐 DNS Change Alert System

Location: scripts/dns/

Real-time DNS monitoring and change notification system with NIS2 compliance support.

Features:

  • πŸ”” Instant email notifications when DNS records change
  • πŸ“Š Comprehensive domain and account reporting (CSV/JSON)
  • 🌐 Multi-Server DNS support (clustered environments)
  • πŸ“‹ Complete audit trail for compliance
  • πŸ›‘οΈ NIS2 Directive (EU) 2022/2555 compliance documentation

Quick Start:

# From directadmin root directory
cd scripts/dns

# Install hooks
sudo install -d -m 0755 /usr/local/directadmin/scripts/custom

sudo cp all_pre.sh /usr/local/directadmin/scripts/custom/
sudo cp da_report.sh /usr/local/directadmin/scripts/custom/
sudo cp dns_raw_save_post.sh /usr/local/directadmin/scripts/custom/
sudo cp dns_write_post.sh /usr/local/directadmin/scripts/custom/

sudo chmod 755 /usr/local/directadmin/scripts/custom/all_pre.sh
sudo chmod 755 /usr/local/directadmin/scripts/custom/da_report.sh 
sudo chmod 755 /usr/local/directadmin/scripts/custom/dns_raw_save_post.sh 
sudo chmod 755 /usr/local/directadmin/scripts/custom/write_post.sh

# Install reporting tool
sudo cp da_report.sh /usr/local/bin/da_report
sudo chmod +x /usr/local/bin/da_report

# Test
sudo tail -f /var/log/da-hooks/dns_notify.log

Documentation:

Use Cases:

  • Detect unauthorized DNS changes immediately
  • Maintain NIS2/compliance audit trails
  • Alert domain owners of DNS modifications
  • Monitor multi-server DNS infrastructure
  • Generate domain and account inventories

🎯 Quick Links by Use Case

For Hosting Providers

  • DNS Monitoring: scripts/dns/ - Alert customers automatically
  • Compliance: NIS2 Documentation - Meet EU requirements
  • Reporting: DNS reporting tool for customer inventories

For System Administrators

  • Automation: Browse scripts/ for DirectAdmin automation
  • Hooks: Custom hooks extending DirectAdmin functionality
  • Monitoring: Real-time notification systems

For Security Teams

  • Incident Detection: DNS change alerts for unauthorized modifications
  • Audit Trails: Complete logging with timestamps and attribution
  • Compliance: NIS2 and security documentation

πŸ”§ Getting Started

Prerequisites

  • DirectAdmin 1.60+ installed
  • Root or admin access
  • Bash 4.0+
  • Mail system configured (for notifications)

Installation

# 1. Clone or download this repository
git clone https://github.com/YOUR-USERNAME/directadmin.git
cd directadmin

# 2. Choose your tool
ls scripts/

# 3. Read tool documentation
cat scripts/dns/README.md

# 4. Follow tool-specific installation instructions
cd scripts/dns
# ... follow installation steps in README.md

πŸ“š Documentation

General Documentation

Project-Specific Documentation

Each tool has its own documentation in its directory. See the README.md file in each project folder.


πŸ›‘οΈ Security

Security Best Practices

  • βœ… All scripts run with appropriate permissions
  • βœ… Input validation and sanitization
  • βœ… Secure file handling (no injection risks)
  • βœ… Audit logging for all actions
  • βœ… Regular security updates

Reporting Security Issues

Found a vulnerability? Report responsibly:


🀝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

What You Can Do:

  • βœ… Report bugs and issues
  • βœ… Suggest features and improvements
  • βœ… Test and provide feedback
  • βœ… Improve documentation

Note: Due to licensing, direct code contributions work differently than typical open source projects.


πŸ“‹ System Requirements

  • OS: Linux (RHEL/CentOS/Rocky/Alma/Debian/Ubuntu)
  • DirectAdmin: Version 1.60 or higher
  • Bash: Version 4.0 or higher
  • Disk Space: ~50MB for scripts and backups
  • Memory: Minimal (scripts are lightweight)

🌍 Supported Platforms

Platform Status
RHEL 9 / Rocky Linux 9 βœ… Fully Supported
CentOS 7/8 βœ… Supported
AlmaLinux 8/9 βœ… Supported
Debian 11/12 βœ… Supported
Ubuntu 20.04/22.04/24.04 βœ… Supported

πŸ“œ License

ITCMS.GR Free License – All Rights Reserved

Copyright Β© 2025 Antonios Voulvoulis, ITCMS.GR

This software is free for personal, internal, or commercial use. You may not modify, redistribute, or sell this software.

SPDX License Identifier: LicenseRef-ITCMS-Free-1.0

See LICENSE.txt for full terms.


πŸ“ž Support

Documentation & Help

Professional Services

Need custom development, integration, or consulting?

  • Custom scripts for your infrastructure
  • Integration with monitoring/SIEM systems
  • Team training on DirectAdmin automation
  • Support contracts with SLA guarantees
  • NIS2 compliance consulting

Contact: contact@itcms.gr


πŸ—ΊοΈ Roadmap

Current Version: 1.0.0

  • βœ… DNS Change Alert System
  • βœ… Domain/Account Reporting
  • βœ… NIS2 Compliance Documentation
  • βœ… Multi-Server DNS Support

πŸ™ Acknowledgments

  • DirectAdmin team for excellent documentation
  • Open source community for shell scripting best practices
  • EU NIS2 working groups for security guidance
  • Our users and testers for valuable feedback

πŸ“ Changelog

See CHANGELOG.md for version history.

Latest Release: v1.0.0 (2025-10-29)


πŸ’‘ About ITCMS

ITCMS.GR develops professional tools for hosting providers, system administrators, and digital infrastructure operators.

Website: https://itcms.gr


Made with ❀️ by ITCMS

Professional Tools for DirectAdmin Administration

Website β€’ Support β€’ Security

About

DirectAdmin Panel automation and monitoring tools

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages