title: Interface Lock Scripts
created at: Mon Nov 04 2024 07:07:40 GMT+0000 (Coordinated Universal Time)
updated at: Sat Feb 08 2025 14:22:50 GMT+0000 (Coordinated Universal Time)
---
# Interface Lock Scripts
# Overview
We added scripts to manage the Interface Lock System. We created the Interface Lock System to block user changes to various features during cPanel & WHM upgrades. The Interface Lock System can manage global or user-specific blocks. This document contains the scripts that you can use to mange the Interface Lock System.
!! Warning:
!! You should **only** use the scripts provided in this article for maintenance purposes.
!! Do **not** use these scripts unless cPanel support instructs you to do so.
# Interface lock names
* `UpdateHostname`
* *Global* — cPanel & WHM uses this lock to block hostname change requests while the system processes a hostname update.
* *User* — cPanel & WHM uses this lock to prevent user access to the Horde webmail interface and the CalDAV/CardDAV protocols during a hostname change.
# Scripts
`/usr/local/cpanel/bin/is_interface_locked` — Use this script to check whether an interface lock exists.
Options:
* `--help` — Displays the help information.
* `--version` — Displays the script version.
* `--name` — The WHM or cPanel interface lock name.
* `--user` — The cPanel user.
`/usr/local/cpanel/bin/lock_interface` — Use this script to lock an interface.
Options:
* `--help` — Displays the help information.
* `--version` — Displays the script version.
* `--name` — The WHM or cPanel Interface lock name.
* `--user` — The cPanel user.
* `--all` — All cPanel users.
!! Note:\
The `--all` option does **not** indicate a global lock.
`/usr/local/cpanel/bin/unlock_interface` — Use this script to unlock an interface.
Options:
* `--help` — Displays the help information.
* `--version` — Displays the script version.
* `--name` — The WHM or cPanel interface lock name.
* `--user` — The cPanel user.
* `--all` — All cPanel users.
!! Note:\
The `--all` option does **not** indicate a global lock