cpanel-cli 0.26.0

A command line interface for the cPanel Unrestricted API.

cPanel Command Line Interface

LÉAME en español

A command line interface for the cPanel Unrestricted API.

Swiftly execute commands in a terminal to manage a website, bypassing the need to log into cPanel and navigate through its web interface. This utility can also be seamlessly integrated into scripting tasks.

A portion of the cPanel UAPI (Unrestricted API) is implemented, enabling you to perform a wide array of functions with ease.

Some examples:

• Create a backup of the account and store it in the remote user’s home directory:

  $ cpanel create backup home [e-mail]

• Directly write files to the remote user’s home directory:

  $ cpanel write file public_html/index.txt "Hallo\nTschüss\n"

• Create a new FTP user with a quota and personal directory:

  $ cpanel create ftp [e-mail] 'password' 1024 my_ftp

• Create an email autoresponder:

  $ cpanel set mail autoresponder \
    [e-mail] \
    "Bruce Scott" \
    "This is an automatic message" \
    "I’m currently unavailable, please contact my boss." \
    "Tomorrow 6 PM" \
    "December 15, 8:00 AM"

• Set the cPanel user interface language to French:

  $ cpanel set locale fr

• List cPanel available features:

  $ cpanel list features
  
  {
      "addoncgi": 0,
      "addondomains": 1,
      "agora": 1,
      . . .
      "webmail": 1,
      "webprotect": 1,
      "zoneedit": 1
  }

• List cPanel email accounts:

  $ cpanel list mail accounts
  
    [
        {
        "email": "[e-mail]",
        . . .
        }
    ]

And many more things. I intend to eventually fully cover the 500+ API functions available.

The output is JSON, so it’s easily parsable using a CLI JSON processor, like jq

See the User’s Guide for a complete reference of the implemented API functions.

Quick Start Guide

cpanel-cli works on Linux and macOS (it might work on Windows) and requires Python 3.11 or later.

For Linux, install Python 3.11 or later using your distro’s package manager.

For macOS, install Python 3.11 or later using Homebrew.

Create a .cpanelrc file in your $HOME directory with the following contents:

hostname=example.com
username=scott
utoken=ABCDEFGHIJKLMNOPQSRTUVWXYZ012345

• hostname is the hostname of your cPanel instance

• username is your username in your instance

• utoken is an API token associated with username. See How to create an API token.

Then run:

$ python3 -m pip install --user cpanel-cli

Test the installation using:

$ cpanel --version

User’s Guide

See the User’s Guide at https://cpanel-cli.readthedocs.io/en/stable/ for detailed installation and configuration instructions, as well as a complete reference of the implemented API functions.

Contributing

Pull requests are more than welcome. See CONTRIBUTING for a detailed guide on how to collaborate with this project.

What about Windows?

cpanel-cli should work on Windows 10/11 using WSL 2 (Windows Subsystem for Linux).

Unfortunately I don’t have access to a Windows system, so I can’t confirm this.

---

Interfaz de línea de comandos para cPanel

README in English

Una interfaz de línea de comandos para la Unrestricted API de cPanel.

Ejecute comandos rápidamente en una terminal para gestionar un sitio web, evitando la necesidad de iniciar sesión en cPanel y navegar por su interfaz web. Esta utilidad también se puede integrar sin problemas en tareas de scripting.

Se implementa una parte de la UAPI (API sin restricciones) de cPanel, lo que le permite realizar una amplia gama de funciones con facilidad.

Algunos ejemplos:

• Crear una copia de seguridad de la cuenta y almacenarla en el directorio home del usuario remoto:

  $ cpanel create backup home [e-mail]

• Escribir directamente archivos en el directorio home del usuario remoto:

  $ cpanel write file public_html/index.txt "Hallo\nTschüss\n"

• Crear un nuevo usuario FTP con una cuota y un directorio personal:

  $ cpanel create ftp [e-mail] 'password' 1024 my_ftp

• Crear una respuesta automática de correo electrónico:

  $ cpanel set mail autoresponder \
    [e-mail] \
    "Bruce Scott" \
    "Este es mensaje automático" \
    "No estoy disponible por el momento, por favor contacte a mi jefe." \
    "Tomorrow 6 PM" \
    "December 15, 8:00 AM"

• Cambiar a francés el idioma de la interfaz de usuario de cPanel:

  $ cpanel set locale fr

• Listar las características disponibles de cPanel:

  $ cpanel list features
  
  {
      "addoncgi": 0,
      "addondomains": 1,
      "agora": 1,
      . . .
      "webmail": 1,
      "webprotect": 1,
      "zoneedit": 1
  }

• Listar las cuentas de correo electrónico de cPanel:

  $ cpanel list mail accounts
  
    [
        {
        "email": "[e-mail]",
        . . .
        }
    ]

Y muchas cosas más. Con el tiempo espero cubrir completamente las más de 500 funciones disponibles en el API.

La salida es JSON, por lo que es fácilmente analizable utilizando un procesador CLI de JSON, como por ejemplo jq

Consulte la Guía del usuario para una referencia completa de las funciones implementadas de la API.

Guía rápida

cpanel-cli funciona en Linux y macOS (podría funcionar en Windows) y requiere Python 3.11 o posterior.

Para Linux, instale Python 3.11 o posterior utilizando el gestor de paquetes de su distro.

Para macOS, instale Python 3.11 o posterior usando Homebrew.

Cree un archivo .cpanelrc en su directorio $HOME con el siguiente contenido:

hostname=example.com
username=scott
utoken=ABCDEFGHIJKLMNOPQSRTUVWXYZ012345

• hostname es el nombre de host su instancia de cPanel

• username es su nombre de usuario en la instancia

• utoken es un token API asociado con el username. Lea cómo crear un token API.

A continuación, ejecute:

$ python3 -m pip install --user cpanel-cli

Pruebe la instalación:

$ cpanel --version

Guía del usuario

Consulte la Guía del usuario en https://cpanel-cli.readthedocs.io/es/stable/ para instrucciones detalladas de instalación y configuración, así como una referencia completa de las funciones implementadas del API.

Cómo contribuir

Los pull requests son más que bienvenidos. Consulte CONTRIBUTING en español para una guía detallada de cómo colaborar con este proyecto.

¿Se puede usar en Windows?

cpanel-cli debería funcionar en Windows 10/11 vía WSL 2 (Windows Subsystem for Linux).

Desafortunadamente no tengo acceso a un sistema Windows, así que no puedo confirmarlo.