This website uses cookies

Our website, platform and/or any sub domains use cookies to understand how you use our services, and to improve both your experience and our marketing relevance.

📣 Try the fastest hosting platform with pay-as-you-go pricing & 24/7 expert support! MIGRATE NOW →

How to Install and Manage WordPress From the Terminal WP-CLI

Updated on March 17, 2023

10 Min Read
WordPress CLI

WordPress is one of the most popular CMSs for creating and managing websites. While WordPress has a user-friendly graphical user interface (GUI) for managing content and settings, it also provides a powerful Command-Line Interface (CLI) called WP-CLI.

WP-CLI is a set of command-line tools for managing WordPress installations that can be used in your computer’s Terminal or command prompt. It allows you to perform various tasks such as updating WordPress, plugins, and themes, managing users and roles, and exporting and importing data without leaving the Terminal.

In this article, I’ll tell you how to install and use WP-CLI to manage a WordPress website from the Terminal, including basic and advanced WP-CLI commands for different tasks. So let’s get started!

An Overview of WP-CLI

WP-CLI is an open-source project that is actively developed and maintained by a community of developers. It is compatible with most UNIX-like operating systems, including Linux, macOS, and Windows. WP-CLI requires PHP 5.6.0 or later and can be installed as a global package or a local dependency using the Composer package manager.

One of the main advantages of using WP-CLI is its speed and efficiency. Using command-line tools is often faster than navigating through a GUI, especially when performing repetitive tasks or automating complex operations. WP-CLI commands can be easily scripted and integrated with other command-line tools, making them powerful for developers.

💡 Quick info: Cloudways is a premium sponsor of WP-CLI to help and maintain this open-source project.

Try our WP-CLI Friendly Platform for a Seamless WordPress Control Experience!

Try Cloudways Managed WordPress hosting for built-in WP-CLI and quickly manage your WordPress tasks.

Advantages of WP-CLI

Here are some advantages of using WP-CLI for WordPress.

1. Speed and Efficiency

WP-CLI allows you to perform a wide range of actions on your WordPress site quickly and efficiently, without the need for manual intervention. This can be particularly useful for managing large or complex sites and automating routine tasks.

2. Improved Productivity

With WP-CLI, you can perform multiple tasks simultaneously, saving time and increasing productivity. This can be particularly useful for developers working on multiple sites simultaneously.

3. Enhanced Control

WP-CLI gives you greater control over your WordPress site, allowing you to manage files, plugins, themes, and other components more effectively. This can be particularly useful for developers who need to debug or troubleshoot issues on their site.

4. Improved Security

WP-CLI allows you to manage user accounts, passwords, and other security-related aspects of your site more easily, which can help you to maintain a more secure and stable WordPress installation.

5. Task Automation

WP-CLI can automate many common WordPress tasks, such as backups, updates, and optimization. This can save you time and reduce the risk of human error.

Requirements of WP-CLI

To install WP-CLI, you need a hosting solution that offers SSH access.

Many shared hosting providers usually do not offer SSH access. However, almost all popular WordPress hosting offers SSH access to your server. Please make sure your environment meets the following minimum requirements before installing WP-CLI.

  • PHP: WP-CLI requires PHP 5.6.0 or later. PHP 7 or later is recommended.
  • WordPress: WP-CLI is designed to work with WordPress 3.7 or later.
  • Operating System: WP-CLI is compatible with Linux, macOS, and Windows OS. However, WP-CLI offers limited support in the Windows environment.

These are the basic requirements to install and use WP-CLI. The specific requirements may vary depending on the plugins and themes used on your WordPress site.

💡 Note: I’ll use Cloudways’ managed hosting Platform for running WP-CLI commands.

How to Install WP-CLI

To install WP-CLI, you can follow these simple steps:

  • Step 1: Connect to the Root Directory via SSH
  • Step 2: Download WP-CLI on Your Server

Step 1: Connect to the Root Directory via SSH

To use SSH access to your server, you need credentials (admin username, password), server IP, and port. Next, you must create the key pair. Follow the link below for different operating systems:

  • For Windows, PuTTY;
  • For Linux, Ubuntu;
  • For Mac, Termius.

For this article, I use PuTTY. However, you can use any other terminal emulator of your choice.

  • In PuTTY, go to Sessions;
  • Enter the Host Name (or IP address) and Port;
  • Select SSH for Connection Type;
  • Click the Open button at the end.

connect server

In the next step, the process will prompt you to enter your username and password, which you can find in the Server Details.

server details cli

Step 2: Download WP-CLI on Your Server

If you are a Cloudways user, you can skip this step and directly jump to the WP-CLI management part. Because Cloudways servers come with preinstalled and preconfigured WP-CLI.

If you are on any VPS or using a different hosting, run the following command to download the WP-CLI:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

download wp cli phar

 

chmod +x wp-cli.phar

chmod wp cli

php wp-cli.phar --info

wp cli phar info

How to Use WP-CLI

Once you have installed WP-CLI on your computer, you can open a Terminal window and run different WP-CLI commands by typing “wp” followed by the command and its arguments.

  1. Manage WordPress via WP-CLI
  2. Manage WordPress Theme via WP-CLI
  3. Manage WordPress Plugin via WP-CLI
  4. Manage WordPress Core via WP-CLI
  5. Manage WordPress Multisite via WP-CLI
  6. Search or Replace Strings via WP-CLI
  7. List All Supported Commands of WP-CLI

1. Manage WordPress via WP-CLI

The next step involves downloading and configuring WordPress through WP-CLI commands.

Download WordPress

The following command will download the latest version of the WordPress core files.

wp core download

wp core download

Create wp-config File

Use the following command to create the wp-config.php file that contains the main configuration settings for the WordPress website.

wp config create --dbname=testing --dbuser=wp --dbpass=securepswd --locale=ro_RO

For this article, I have used the following database details:

  • Database Name: testing
  • Database Username: wp
  • Database Password: securepswd

Examples of the Command Options

The above-mentioned command is just one of the variations that highlight the power of WP-CLI. As you can guess, this generates the standard version of the wp-config file.

The following variation will set up the wp-config file with WP_DEBUG and WP_DEBUG_LOG.

# Enable WP_DEBUG and WP_DEBUG_LOG

wp config create --dbname=testing --dbuser=wp --dbpass=securepswd --extra-php <<PHP

define( 'WP_DEBUG', true );

define( 'WP_DEBUG_LOG', true );

PHP

#Success: Generated 'wp-config.php' file.

There is always a chance that the admin user credentials can get stored in the bash shell history. This can become a serious security breach. WP-CLI provides a version of the wp-config command to deal with the issue.

# Avoid disclosing password to bash history by reading from password.txt

# Using --prompt=dbpass will prompt for the 'dbpass' argument

$ wp config create --dbname=testing --dbuser=wp --prompt=dbpass < password.txt

#Success: Generated 'wp-config.php' file.

Create Database

Use the following command to create the database. Note that this command will create a fresh database with the name used in the wp-config file.

wp db create

db created

Install WordPress

It is easy to install WordPress from the command line using WP-CLI on your server. The command requires parameters including URL, Title, Admin Username, Password, and Admin Email.

wp core install --url=your_domain --title=Your_Blog_Title --admin_user=username --admin_password=password --admin_email=your_email.com

wordpress core install

Congratulations! Your WordPress site has been set up successfully.

2. Manage WordPress Theme via WP-CLI

Using WP-CLI, you can connect the server directly to the WordPress theme repository and import the theme quickly. Installing and activating WordPress via WP-CLI processes are simple. You can also update and delete themes through WP-CLI as well.

The command wp theme combines options and switches to handle all theme management tasks.

Use the following command to install a theme. For example, Twenty Twenty Two,

wp theme install twentytwentytwo

💡 Note: Make sure you use the theme’s name as it appears in the page URL. For instance, as you can see in the following screenshot, I have used twentytwentytwo as an argument for the command.

twenty twentytwo theme

The system will generate a notification about the installation in progress. To activate the theme, run the following command.

wp theme activate twentytwentytwo

activate theme

Your WordPress website’s theme will be changed to Twenty Twenty Two.

If you want to learn more about the SSH terminal, check out this article on handling files and folders with an SSH terminal.

3. Manage WordPress Plugin via WP-CLI

Installing WordPress plugins via WP-CLI is almost instantaneous as no time is wasted clicking buttons. Also, you might not even have to log in to the WordPress admin panel to install the plugins.

To install a WordPress plugin, run the following command.

wp plugin install [plugin name]

💡 Note: Replace [plugin name] with the name of the plugins as it appears in the page URL. For example, to install Contact Form 7, use contact-form-7 as shown in the following image.

contact form 7

Let’s also install WooCommerce, a popular plugin for creating ecommerce stores on WordPress. Start by typing the following command.

wp plugin install woocommerce

It takes just a few moments to install the plugin, and to activate it, run the following command.

wp plugin activate woocommerce

activate woocommerce plugin

4. Manage WordPress Core via WP-CLI

To check the version of the WordPress Core, run the following command.

wp core version

wp core version

That will return the version of the WordPress Core. To update the Core files, run the following command.

wp core update

wp core update

The WordPress Core will be updated to the latest available version on WordPress.org.

5. Manage WordPress Multisite via WP-CLI

If you are a web agency with many clients, WP-CLI is the quickest method for updating all the sites on WordPress Multisite.

To run WP-CLI commands on WordPress Multisite, you must mention the website URL in the network using the –url switch.

wp theme status twentytwentytwo

twenty twenty two theme activate

6. Search or Replace Strings via WP-CLI

Most people face issues when migrating their site to a new host. If you want to replace your old URL with a new one, then the search and replace command would help.

Use the following WP-CLI command for search & replace:

wp search-replace <‘old’> <‘new’>

wp search-replace https://oldsite.com https://newsite.com

wp search and replace

7. List All Supported Commands of WP-CLI

To start using WP-CLI, type wp and hit Enter. The system will list all the supported commands for managing WordPress via WP-CLI.

Run the following command to get more details about the command and its options.

wp help <command name>

For example, run the following command to get more details about the plugin commands.

wp help plugin

wp help plugin

List of WP-CLI Commands

Here’s a list of commonly used WP-CLI commands.

Command Function
wp help Details about command and options
wp cli version To check the WP CLI version
php wp-cli.phar –info Making file executable
wp core download Download the latest version of the WordPress core files
wp config create Create config file
wp db create Create a new DB
wp theme install Install theme
wp theme activate Activate theme
wp theme deactivate Deactivate theme
wp plugin install Install plugin
wp plugin activate Activate plugin
wp search-replace Searches/replaces strings in DB
wp help plugin Details about the Plugin command

 

There are many more WP-CLI commands available depending on what you want to accomplish with your WordPress site. The full list of WP-CLI commands and their usage instructions are in the official documentation.

Use WP-CLI on Cloudways

Cloudways Platform has integrated WP-CLI by default in the SSH terminal. To use WP-CLI on Cloudways, please follow the instructions.

  • Sign up or log in to your Cloudways account;
  • Enter Application & Server Details and choose WordPress as your application;
  • Select the server specifications, including the cloud provider, server size, and location;
  • Click on the Launch Now button to create a new server with WordPress site.
  • Click on your newly launched server to proceed to the next screen.

cloudways signup

  • Go to Server Management → Master Credentials and Launch SSH Terminal.
  • A new terminal window opens on your screen.

launch cw terminal

From Server Management, you can find the Master Credentials for logging into the terminal. The easiest way to log in is to copy and paste the credentials into the space provided. Right-click on the system to paste the username and password.

cloduways server terminal

If you use multiple WordPress sites, you should select the site you want to work with via WP-CLI.

Type ls command and find out where you are in the directory structure.

ls command

See the subdirectories in the applications folder running the following command.

cd applications

cd applications command

Since I want to go to the Applications folder, I will run the following command:

ls

ls command

As you can see, I have several applications installed on the server. I will select the application I want to update.

To do this, type the cd command with the name of the target application.

cd [application name]

cd folder

Go to the public_html directory by running the following command.

cd public_html/

cd public html

That’s it, now you can easily manage your WordPress application through WP-CLI.

Summary

With a wide range of commands available, WP-CLI makes it easy to install, activate, deactivate, update, and manage WordPress plugins, themes, and core files. It can also be used to manage posts, users, and the WordPress database, making it a powerful tool for WordPress management.

Whether you’re managing a single site or multiple sites, WP-CLI can streamline your workflow and save you time and effort. You can become a more efficient WordPress site manager and developer by mastering the various WP-CLI commands.

Frequently Asked Questions

Q. How to run WP CLI commands on WordPress?

Follow the below steps to run the WP CLI commands.

  1. Connect to the Root Directory via SSH;
  2. Download WP-CLI on Your Server;
  3. Install WordPress and start using WP CLI.

Q. In which directory can we install WordPress?

It would be great if you installed WordPress in your root directory. On Cloudways, we install it on the public_html folder.

Q. How to see users in WP-CLI?

Here’s the command to see the users in WP-CLI.

wp user list --field=ID

Q. How can you directly activate and deactivate plugins on WP-CLI?

You can install a plugin with the “wp plugin install” command.

wp plugin install woocommerce

You can activate a plugin with “wp plugin activate” command.

wp plugin activate woocommerce

You can deactivate a plugin with “wp plugin deactivate” command.

wp plugin deactivate woocommerce
Share your opinion in the comment section. COMMENT NOW

Share This Article

Farhan Ayub

Farhan is a community manager at Cloudways. He loves to work with WordPress and has a passion for web development. Mostly, he spends his time interacting with the people in the WordPress community. Apart from his work life, Farhan spends his time gaming and playing sports. Feel free to contact him at [email protected]

×

Get Our Newsletter
Be the first to get the latest updates and tutorials.

Thankyou for Subscribing Us!

×

Webinar: How to Get 100% Scores on Core Web Vitals

Join Joe Williams & Aleksandar Savkovic on 29th of March, 2021.

Do you like what you read?

Get the Latest Updates

Share Your Feedback

Please insert Content

Thank you for your feedback!

Do you like what you read?

Get the Latest Updates

Share Your Feedback

Please insert Content

Thank you for your feedback!

Want to Experience the Cloudways Platform in Its Full Glory?

Take a FREE guided tour of Cloudways and see for yourself how easily you can manage your server & apps on the leading cloud-hosting platform.

Start my tour

CYBER WEEK SAVINGS

  • 0

    Days

  • 0

    Hours

  • 0

    Mints

  • 0

    Sec

GET OFFER

For 4 Months &
40 Free Migrations

For 4 Months &
40 Free Migrations

Upgrade Now