How to Create Custom Jailed Shell Mounts, Disable Disk Space Warnings, Disable Services, and Downgrade Local Licenses in cPanel & WHM

How to Downgrade Local License for Testing Last modified: 2024 February 19 Overview This document provides steps to downgrade your server’s local license for testing purposes. You can use the file /var/cpanel/license.cfg to request a restricted cPanel & WHM license. This restricted license will benefit developers who would like to test custom code or experiment with user limitations. The system uses the /var/cpanel/license.cfg file to determine the license request to downgrade your local license. Note: You cannot use this file to upgrade your license. To upgrade your license, contact cPanel Customer Service. Downgrade your local license To downgrade your local license for testing, perform the following steps: From the command line, log in to your cPanel & WHM server as the root user. Open the /var/cpanel/license.cfg file with your favorite editor. Edit the producttype and maxusers values to your desired settings. See the table below for more information. Save the file and refresh the license. To refresh the license, run the /usr/local/cpanel/cpkeyclt script. Available values Variable Type Description Possible values Example producttype string A server profile. databasenode — The Database profile. dnsnode — The DNS profile. dnsonly — The DNSOnly® mode. mailnode — The Mail profile. cloudlinux — The CloudLinux Node profile dnsnode maxusers integer A numeric value. A positive integer that does not exceed the maximum user count for your license. 40

cPanel jailed shell mountsdisable disk space warningsdisable cPanel servicesdowngrade cPanel license

~3 دقیقه مطالعه · آخرین به‌روزرسانی ۲۹ بهمن ۱۴۰۴

1. Create Custom Jailed Shell Mounts


You can create custom jailed shell mounts to allow jailed users read-only access to additional directories or files on the server.


Important: All custom mounts are read-only for jailshell users.


1.1 Add Directories to a Custom Mount


  1. Create the file:
    /var/cpanel/jailshell-additional-mounts
  2. Add each directory path on a separate line:
    /usr/local/test1
    /usr/local/test2
    /usr/local/test3
  3. Save the file.

Warnings:

  • Use absolute paths only.
  • Do not use trailing slashes.
  • Do not place multiple entries on the same line.

1.2 Add Files to a Custom Mount


  1. Create the file:
    /var/cpanel/jailshell-additional-files
  2. Add each file path on a separate line:
    /usr/local/test1.txt
    /usr/local/test2.txt
    /usr/local/test3.txt
  3. Save the file.

1.3 Path Requirements


Correct format:

/usr/local/test1

Incorrect formats:

  • test1 — relative path
  • test1/ — relative + trailing slash
  • /usr/local/test1/ — trailing slash
  • Multiple paths on one line

Warning: Incorrect formatting may cause server failures.


1.4 Unmount a Custom Mount


You cannot remove entries from the mount file to unmount them. Use the umount command:


umount /home/virtfs/username/usr/local/example

The system does not automatically unmount custom mounts when the user logs out.



2. How to Disable Disk Space Warnings


You can disable disk space warnings using two different files depending on your needs.


2.1 Disable Disk Monitoring for Specific Mount Points


Edit the file:

/var/cpanel/chkservd_ignored_mounts

Add one mount point per line:

snap
tempbackup

Rules:

  • Only alphanumeric characters and slashes are allowed.
  • Each entry must be on its own line.
  • You can only ignore entire mount points (e.g., /var), not subdirectories (e.g., /var/tmp).

2.2 Disable All Disk Space Warnings


Create an empty file:

/var/cpanel/disablediskfreecheck

Warning: This allows cPanel to operate even when the server is out of disk space, which may cause system failures.



3. How to Disable Services


cPanel’s nightly maintenance script automatically restarts services. If this causes issues, you can disable specific services.


Disabled services are stored in:

/var/cpanel/disabled

3.1 Disable a Service


Add one of the following touch files:


FileDescription
secureitDisables the secureit script
securetmpDisables /tmp security
terminal-colorsDisables color output in WHM Terminal
cloudlinuxPrevents CloudLinux installation
auto-restart-servicesDisables automatic service restarts


4. How to Downgrade a Local License for Testing


You can downgrade your local license for development or testing using:

/var/cpanel/license.cfg

Note: You cannot upgrade a license using this file.


4.1 Steps to Downgrade


  1. Log in as root.
  2. Edit the file:
    /var/cpanel/license.cfg
  3. Modify the following values:

VariableTypeDescriptionPossible ValuesExample
producttypestringServer profiledatabasenode, dnsnode, dnsonly, mailnode, cloudlinuxdnsnode
maxusersintegerUser limitAny positive integer within license limits40

After editing, refresh the license:

/usr/local/cpanel/cpkeyclt

Conclusion


This guide covers advanced administrative tasks including custom jailed shell mounts, disabling disk space warnings, disabling services, and downgrading local licenses. These tools give system administrators greater flexibility and control over cPanel & WHM environments.


نوشته و پژوهش‌شده توسط دکتر شاهین صیامی

مقالات مرتبط

راهنمای کامل بازیابی اکانت cPanel و انتقال حساب‌ها و تنظیمات برای مدیران سیستم تازه‌کار

این مقاله یک راهنمای جامع برای مدیران سیستم تازه‌کار است که می‌خواهند اکانت‌های cPanel را بازیابی کنند، حساب‌ها و تنظیمات را بین سرورها منتقل کنند، و از ابزارهای تشخیصی برای بررسی مشکلات انتقال و بازیابی استفاده کنند. این راهنما شامل نحوه استفاده از WHM، نحوه آپلود بکاپ‌ها، روش‌های انتقال، و فعال‌سازی لاگ‌های پیشرفته است.

ادامه

How to Move All cPanel Accounts from One Server to Another

This guide explains how to migrate all cPanel accounts, service configurations, SSL certificates, and the main server IP address from an old source server to a new target server. It covers installation requirements, configuration transfers, account migration, IP reassignment, DNS adjustments, and SSL restoration.

ادامه

آموزش کامل مهاجرت یک وب‌سایت وردپرس از macOS به سرور cPanel & WHM

این مقاله نحوه انتقال یک وب‌سایت وردپرس که روی macOS میزبانی شده است را به یک سرور cPanel & WHM توضیح می‌دهد. شامل خروجی گرفتن از دیتابیس، آپلود فایل‌ها، ایجاد دیتابیس جدید، تنظیم wp-config.php، تغییر URL سایت، و رفع لینک‌ها و تصاویر خراب است.

ادامه

آموزش کامل انتقال دستی یک اکانت بین سرورها در cPanel & WHM

این مقاله نحوه انتقال دستی یک اکانت بین دو سرور را زمانی که حجم اکانت برای ابزارهای انتقال WHM بسیار بزرگ است توضیح می‌دهد. شامل ایجاد دایرکتوری موقت، فشرده‌سازی public_html و لاگ‌ها، انتقال امن با scp، و بازیابی فایل‌ها در سرور جدید است.

ادامه

آموزش کامل مهاجرت دستی داده‌های Horde به Roundcube در cPanel & WHM

این مقاله نحوه مهاجرت دستی تقویم‌ها و مخاطبین Horde به Roundcube را در نسخه‌های 108 تا 118 cPanel & WHM توضیح می‌دهد. شامل مراحل خروجی گرفتن از Horde، انتقال فایل‌ها به مسیرهای صحیح، و وارد کردن داده‌ها در Roundcube با استفاده از افزونه‌های داخلی یا ابزارهای واردسازی است.

ادامه

آموزش کامل مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM

این مقاله نحوه مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM را توضیح می‌دهد. شامل اقدامات قبل از مهاجرت، نصب سرور جدید، انتقال فایل‌ها و دایرکتوری‌ها، بازیابی دیتابیس‌ها، انتقال SSL، و اقدامات پس از مهاجرت است.

ادامه