Introduction
When installing cPanel & WHM, the installation process may be interrupted because of an unexpected server restart, network connectivity issue, or other interruption.
If you attempt to restart the installation using:
sh latest
you may encounter the following error:
The system detected an installer lock file: (/root/installer.lock) Make certain that an installer is not already running. You can remove this file and re-run the cPanel installation process after you are certain that another installation is not already in progress.
This happens because the cPanel installer has detected an existing installer.lock file.
Scenario
Suppose the cPanel/WHM installation was interrupted because of an unexpected system restart or an internet connection issue.
When you try to start the installation again:
sh latest
the installer detects:
/root/installer.lock
and prevents the installation from continuing.
Prerequisites
Before removing the lock file, make sure that:
- You have root access to the server.
- The cPanel/WHM installation is not currently running.
- You have confirmed that the previous installation process was interrupted.
Implementation
Step 1: Check the Installer Lock File
The installer lock file is located at:
/root/installer.lock
If the previous installation has definitely stopped and no other cPanel installation process is running, the lock file can be removed.
Step 2: Remove the Installer Lock File
From the command line, run:
rm -rf /root/installer.lock
This removes the existing installer lock file.
Step 3: Restart the cPanel Installation
After confirming that no other installation is running, start the cPanel installation again:
sh latest
The installation process should now be able to continue.
Conclusion
The /root/installer.lock error can occur when a previous cPanel/WHM installation is interrupted and leaves behind the installer lock file.
If you have confirmed that no cPanel installation is currently running, remove the lock file:
rm -rf /root/installer.lock
and then restart the installation:
sh latest
This allows the cPanel installer to proceed after an interrupted installation.
Frequently Asked Questions
1. Why does cPanel show the installer.lock error?
The error indicates that cPanel has detected an installer lock file, usually because an earlier installation process was interrupted or did not complete properly.
2. Can I safely remove /root/installer.lock?
Only remove the file after confirming that another cPanel installation process is not currently running. Removing the lock file while an installation is active could interfere with the installation process.
3. What command starts the cPanel installation again?
The installation can be started with:
sh latest
after resolving the installer-lock condition.
Related Articles
Talk to our experts
Looking for the right technology solution for your business? Our team of experts can help you with development, cloud, DevOps, design, and a wide range of other technology needs. Get in touch with our team here.