ConfigServer Tools Installer

Interactive installer and uninstaller wrapper for free ConfigServer tools on common Linux hosting control panels.

This project helps Linux server administrators install or remove supported ConfigServer tools through a simple interactive Bash menu.

---

Supported Products

• CSF — ConfigServer Security & Firewall
• CMC — ConfigServer ModSecurity Control
• CMM — ConfigServer Mail Manage
• CMQ — ConfigServer Mail Queues
• CSE — ConfigServer Explorer

---

Supported Control Panels

• cPanel
• CWP
• CyberPanel
• DirectAdmin
• InterWorx
• Generic Linux server
• Vesta

---

Quick Run

Run directly as root:

bash <(curl -fsSL https://raw.githubusercontent.com/homfar/configserver/main/installer.sh)

The script will ask you to select:

1. Control panel
2. ConfigServer product
3. Install or uninstall mode

---

Safer Manual Run

For production servers, it is better to download and review the script before running it:

curl -fsSLo installer.sh https://raw.githubusercontent.com/homfar/configserver/main/installer.sh
less installer.sh
bash installer.sh

The script must be executed as root.

---

Requirements

• Linux server
• Root access
• bash
• curl
• tar
• mktemp
• Supported hosting control panel for panel-specific installers

Install common dependencies on Debian/Ubuntu:

apt update
apt install -y bash curl tar coreutils

Install common dependencies on AlmaLinux/Rocky/CentOS:

dnf install -y bash curl tar coreutils

---

How It Works

The script:

1. Shows an interactive menu.
2. Asks for the hosting control panel.
3. Asks for the ConfigServer product.
4. Asks whether to install or uninstall.
5. Downloads the required installer or uninstaller.
6. Runs the selected script through bash.
7. Cleans up the temporary working directory after completion.

The working directory is created under:

/usr/local/src

Using /usr/local/src helps avoid common issues caused by /tmp being mounted with noexec.

---

Usage Flow

Start script
  |
  +-- Select control panel
  |
  +-- Select product
  |
  +-- Choose install or uninstall
  |
  +-- Download required package/script
  |
  +-- Run installer or uninstaller
  |
  +-- Cleanup

---

Repository

https://github.com/homfar/configserver

---

Notes

• This repository provides an automation wrapper for supported ConfigServer tools.
• It is intended for experienced Linux/server administrators.
• Review the script before running it on production servers.
• Keep backups and emergency console access before changing firewall or security components.
• Installing or removing CSF and related tools may affect network access if the server firewall is misconfigured.
• This project is not an official ConfigServer repository.

---

Validation

Check Bash syntax:

bash -n installer.sh

If ShellCheck is available:

shellcheck installer.sh

---

فارسی

نصب‌کننده ابزارهای ConfigServer

این پروژه یک اسکریپت تعاملی Bash برای نصب یا حذف ابزارهای رایگان ConfigServer روی سرورهای لینوکسی و کنترل‌پنل‌های هاستینگ است.

هدف پروژه ساده‌سازی نصب و حذف ابزارهایی مثل CSF، CMC، CMM، CMQ و CSE برای مدیران سرور است.

---

محصولات پشتیبانی‌شده

• CSF — فایروال و ابزار امنیتی ConfigServer
• CMC — مدیریت ModSecurity
• CMM — مدیریت ایمیل
• CMQ — مدیریت صف ایمیل
• CSE — ابزار Explorer مربوط به ConfigServer

---

کنترل‌پنل‌های پشتیبانی‌شده

• cPanel
• CWP
• CyberPanel
• DirectAdmin
• InterWorx
• Generic Linux server
• Vesta

---

اجرای سریع

bash <(curl -fsSL https://raw.githubusercontent.com/homfar/configserver/main/installer.sh)

بعد از اجرا، اسکریپت از شما می‌پرسد:

1. کنترل‌پنل سرور چیست
2. کدام محصول ConfigServer نصب یا حذف شود
3. عملیات نصب انجام شود یا حذف

---

اجرای امن‌تر

برای سرورهای production بهتر است ابتدا اسکریپت را دانلود و بررسی کنید:

curl -fsSLo installer.sh https://raw.githubusercontent.com/homfar/configserver/main/installer.sh
less installer.sh
bash installer.sh

اسکریپت باید با دسترسی root اجرا شود.

---

پیش‌نیازها

• سرور لینوکسی
• دسترسی root
• bash
• curl
• tar
• mktemp
• کنترل‌پنل سازگار برای نصب‌های وابسته به پنل

نصب پیش‌نیازهای عمومی روی Debian/Ubuntu:

apt update
apt install -y bash curl tar coreutils

نصب پیش‌نیازهای عمومی روی AlmaLinux/Rocky/CentOS:

dnf install -y bash curl tar coreutils

---

نحوه کار

اسکریپت:

1. یک منوی تعاملی نمایش می‌دهد.
2. کنترل‌پنل سرور را دریافت می‌کند.
3. محصول ConfigServer را دریافت می‌کند.
4. حالت نصب یا حذف را مشخص می‌کند.
5. فایل installer یا uninstaller لازم را دانلود می‌کند.
6. اسکریپت انتخاب‌شده را با bash اجرا می‌کند.
7. فایل‌های موقت را بعد از پایان عملیات پاک می‌کند.

دایرکتوری کاری در این مسیر ساخته می‌شود:

/usr/local/src

استفاده از /usr/local/src باعث می‌شود مشکلات رایج مربوط به noexec بودن /tmp کمتر شود.

---

نکات مهم

• این پروژه یک wrapper برای ساده‌سازی نصب و حذف ابزارهای ConfigServer است.
• برای مدیران سرور و کاربران باتجربه لینوکس مناسب است.
• قبل از اجرا روی سرور production، محتوای اسکریپت را بررسی کنید.
• قبل از تغییر ابزارهای firewall/security، دسترسی اضطراری یا کنسول سرور داشته باشید.
• نصب یا حذف CSF و ابزارهای امنیتی مشابه می‌تواند روی دسترسی شبکه تأثیر بگذارد.
• این پروژه repository رسمی ConfigServer نیست.

---

اعتبارسنجی

بررسی syntax اسکریپت:

bash -n installer.sh

اگر ShellCheck نصب است:

shellcheck installer.sh

---

License

Released under the GPL-3.0 License.