{"id":7063,"date":"2016-09-17T15:30:52","date_gmt":"2016-09-17T12:30:52","guid":{"rendered":"https:\/\/help.superhosting.bg\/en\/?p=7063"},"modified":"2025-10-17T09:43:10","modified_gmt":"2025-10-17T06:43:10","slug":"wp-cli","status":"publish","type":"ht_kb","link":"https:\/\/help.superhosting.bg\/en\/wp-cli.html","title":{"rendered":"WP-CLI – Managing WordPress via SSH"},"content":{"rendered":"\n

<\/span>What is WP-CLI?<\/span><\/h2>\n\n\n\n

WP-CLI<\/strong><\/a> is a set of command line tools, executed through a console. WP-CLI allows you to manage multiple WordPress installations in your hosting account.<\/p>\n\n\n\n

You can backup databases easily and quickly, automatically update WP, plugins and themes as well as automatically install several WordPress instances without using a web browser. This saves precious time when multiple WP installations are managed.<\/p>\n\n\n\n

Depending on the tool specifications, you need WordPress 3.7<\/strong> version or a later one.<\/p>\n\n\n\n

Since the tool is used through a console, you also have to activate SSH access for your hosting account.<\/p>\n\n\n\n

<\/span>Using WP-CLI<\/span><\/h2>\n\n\n\n

WP-CLI<\/a> is installed on all Linux shared hosting servers<\/a> with SuperHosting.BG. In cPanel \u00bb WordPress Manager by SuperHosting<\/a> \u00bb WP-CLI you can check whether WP-CLI is enabled for your hosting account.<\/p>\n\n\n\n

Important<\/strong>: To work with WP-CLI in your hosting account you can use wp-cli<\/strong> command in the console.<\/p>\n\n\n\n

Commands might be directly executed in a certain WordPress directory as well as outside the WordPress installation. The command specifies the installation that shall be modified.<\/p>\n\n\n\n

For example, WordPress is installed in the following directory:<\/p>\n\n\n\n

\/home\/cpaneluser\/public_html\/wordpress<\/strong><\/p>\n\n\n\n

Note: cpaneluser is the username for the hosting account.<\/em><\/p>\n\n\n\n

<\/span>Some basic wp-cli commands <\/span><\/h3>\n\n\n\n

To check the WordPress theme version you can type the following command in the console:<\/p>\n\n\n\n

wp-cli theme status –path=\/home\/cpaneluser\/public_html\/wordpress<\/p>\n\n\n\n

If you have already accessed the directory through the console, you can also execute the command:<\/p>\n\n\n\n

wp-cli theme status<\/p>\n\n\n\n

If the WordPress version is older than 3.4, you can update the system by using:<\/p>\n\n\n\n

wp-cli core download –force<\/p>\n\n\n\n

After the abovementioned command is executed, you will also need to update the database. Before that, be sure to perform a database backup:<\/strong><\/p>\n\n\n\n

wp-cli db export mydbfile.sql<\/p>\n\n\n\n

The database named mydbfile.sql will be exported to the website’s directory.<\/p>\n\n\n\n

The command for updating the database<\/strong> is:<\/p>\n\n\n\n

wp-cli core update-db<\/p>\n\n\n\n

To install a plugin<\/strong> you can use:<\/p>\n\n\n\n

wp-cli plugin install –activate bbpress<\/p>\n\n\n\n

If WordPress has been installed in a language different from English and you want to install a plugin or a theme, WP-CLI will try to install them in the same language. If the installed plugin or theme is not translated, the console might display warning messages. Despite them, the installation should be successful.<\/p>\n\n\n\n

We recommend that you allocate more RAM for PHP processing, especially when it comes to the latest WordPress versions. You can allocate 128 MB, for example.<\/p>\n\n\n\n

<\/span>wp-cli configuration file<\/span><\/h3>\n\n\n\n

Further wp-cli settings can be configured in the wp-cli.yml<\/a> file.<\/p>\n\n\n\n

This file can be placed into the WordPress directory so that to apply for the website. If a global setting is necessary for all WordPress installations, the configuration file might be placed in home directory.<\/p>\n\n\n\n

<\/span>Update WordPress with cron job<\/span><\/h3>\n\n\n\n

If there are multiple WordPress instances installed into your hosting account and you decide to update them manually, the action may take quite a long time especially if there are many plugins.<\/p>\n\n\n\n

You can try doing it automatically by using a configuration of few wp-cli commands in a file.<\/p>\n\n\n\n

For example, first you have to create a new file in the hosting account’s home directory: \/home\/cpaneluser\/wpupdateall.sh<\/strong>. Then type the following commands:<\/p>\n\n\n\n

wp-cli db export --path=\/home\/cpaneluser\/public_html\/wp1<\/code>
wp-cli db export --path=\/home\/cpaneluser\/public_html\/wp2<\/code>
wp-cli core update --path=\/home\/cpaneluser\/public_html\/wp1<\/code>
wp-cli core update --path=\/home\/cpaneluser\/public_html\/wp2<\/code>
wp-cli core update-db --path=\/home\/cpaneluser\/public_html\/wp1<\/code>
wp-cli core update-db --path=\/home\/cpaneluser\/public_html\/wp2<\/code>
wp-cli plugin update --all --path=\/home\/cpaneluser\/public_html\/wp1<\/code>
wp-cli plugin update --all --path=\/home\/cpaneluser\/public_html\/wp2<\/code><\/p>\n\n\n\n

In these specific lines you need to add the correct path to the WordPress installation directories.<\/p>\n\n\n\n

The database backup files will be saved to the hosting account’s home directory: \/home\/cpaneluser\/<\/p>\n\n\n\n

The wpupdateall.sh<\/strong> file permissions should be set to 0755. Then you should add the following cron job in cPanel:<\/p>\n\n\n\n

\/usr\/bin\/env PATH=\/usr\/local\/bin:\/usr\/bin:\/bin:\/usr\/local\/bin\/wp-cli \/home\/cpaneluser\/wpupdateall.sh<\/code><\/p>\n\n\n\n

Note: cpaneluser is the username for the hosting account.<\/em><\/p>\n\n\n\n

In a cron job you can start only one wp-cli command without creating additional file in the hosting account:<\/p>\n\n\n\n

\/usr\/bin\/env PATH=\/usr\/local\/sbin:\/usr\/local\/bin:\/usr\/sbin:\/usr\/bin:\/sbin:\/bin \/usr\/local\/bin\/wp-cli db export mydbfile.sql --path=\/home\/cpaneluser\/public_html\/wp332<\/code><\/p>\n\n\n\n

The results from the executed commands might be sent to you by email or saved in a log file.<\/p>\n\n\n\n

<\/span>Restore database backup <\/span><\/h3>\n\n\n\n

If after updating you notice problems with the website’s proper operation, you can restore the database backup or downgrade to the previous WordPress version.<\/p>\n\n\n\n

Recover database from backup<\/strong>:<\/p>\n\n\n\n

wp-cli db import wp1dbbackup.sql –path=\/home\/cpaneluser\/public_html\/wp<\/p>\n\n\n\n

Downgrading to a previous WordPress version<\/strong>:<\/p>\n\n\n\n

wp-cli core download –version=3.4 –force –path=\/home\/cpaneluser\/public_html\/wp1<\/p>\n\n\n\n

(the command is on one line)<\/em><\/p>\n\n\n\n

Do have in mind that an error message might occur when the website is accessed in case you decide to downgrade your WordPress and the version is considerably older than the current one.<\/p>\n","protected":false},"excerpt":{"rendered":"

WP-CLI is a set of\u00a0command line tools, executed through a console. WP-CLI allows you to manage multiple WordPress installations in your hosting account.<\/p>\n","protected":false},"author":11,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"inline_featured_image":false,"_lmt_disableupdate":"","_lmt_disable":"no","footnotes":""},"ht-kb-category":[189],"ht-kb-tag":[],"class_list":["post-7063","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-wordpress"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t