Installation & Setup

Before you can build themes, write plugins, or explore the loop, you need a working WordPress installation. This page walks through what WordPress needs to run, the classic "5-minute install", setting it up locally on XAMPP/WAMP for development, and the WP-CLI command-line workflow that many professional WordPress developers use instead of clicking through the browser wizard.

1. Server Requirements

RequirementRecommended
PHP7.4 or greater (WordPress itself recommends the latest stable PHP 8.x, but 7.4 still runs fine for learning)
DatabaseMySQL 5.7+ or MariaDB 10.3+
Web serverApache with mod_rewrite enabled, or Nginx with an equivalent rewrite configuration
HTTPSStrongly recommended for any live/production site

In practice, the easiest way to satisfy all of this on your own computer is an all-in-one stack like XAMPP or WAMP (this very tutorial site runs on WAMP) — both bundle Apache, PHP, and MySQL/MariaDB together so you don't have to install and configure each piece separately.

2. The Famous "5-Minute Install"

WordPress is well known for how quickly it can be installed. The classic manual process looks like this:

  1. Download the latest release from wordpress.org/download as a .zip file.
  2. Extract it into your web server's document root (for example C:\wamp64\www\mysite on WAMP, or htdocs on XAMPP).
  3. Create an empty MySQL database (and a dedicated database user) for WordPress to use.
  4. Visit the site in your browser — WordPress detects there's no configuration yet and launches the setup wizard.
  5. The wizard asks for your database name, username, password, and host, writes them into wp-config.php for you, then asks for your site title, admin username, admin password, and email.
  6. Click "Install WordPress" and you're done — WordPress creates all its database tables automatically.

3. Configuring wp-config.php Manually

If the setup wizard can't write the file itself (for example, due to file permissions), or if you simply prefer to configure things by hand, copy wp-config-sample.php to wp-config.php and fill in your database details directly:

<?php
define('DB_NAME', 'my_wordpress_db');
define('DB_USER', 'wp_user');
define('DB_PASSWORD', 'a_strong_password');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', '');

// Unique authentication keys and salts - generate your own at
// https://api.wordpress.org/secret-key/1.1/salt/
define('AUTH_KEY',         'put a long random string here');
define('SECURE_AUTH_KEY',  'put a long random string here');
Note: This is a real, correct wp-config.php snippet meant to be copied into your own WordPress installation — this tutorial site itself doesn't run WordPress, so nothing here is executed on this page.

4. Installing Locally with XAMPP or WAMP

For learning and theme/plugin development, running WordPress locally is much faster than deploying to a live server for every test. The workflow is nearly identical on both stacks:

  • Install XAMPP or WAMP and start the Apache and MySQL services from the control panel.
  • Extract WordPress into htdocs (XAMPP) or www (WAMP), inside its own folder, e.g. www/mysite.
  • Open phpMyAdmin (bundled with both stacks) and create a new database, e.g. mysite_db.
  • Visit http://localhost/mysite in your browser and run through the same 5-minute install wizard described above.
Why this matters: Local development means no hosting costs, instant feedback while editing theme/plugin files, and a safe sandbox to break things without affecting a live site.

5. Installing via WP-CLI

WP-CLI is the official command-line tool for WordPress. Many professional WordPress developers prefer it over the browser wizard because it's scriptable, fast, and works well over SSH on remote servers. A typical WP-CLI install looks like this from a terminal, inside your site's folder:

wp core download
wp config create --dbname=my_wordpress_db --dbuser=wp_user --dbpass=a_strong_password --dbhost=localhost
wp core install --url=http://localhost/mysite --title="My Site" --admin_user=admin --admin_password=strongpass --admin_email=you@example.com

wp core download fetches the latest WordPress core files, wp config create generates wp-config.php for you, and wp core install runs the equivalent of the 5-minute wizard entirely from the command line — no browser required. This makes WP-CLI extremely popular for automated deployments, staging environments, and CI pipelines.

6. Logging In and First Look at wp-admin

Once installation finishes, WordPress redirects you to /wp-login.php. Log in with the admin username and password you chose to reach the WordPress Dashboard at /wp-admin/ — this is the control center where you manage posts, pages, media, themes, plugins, users, and settings for the rest of this track.

7. Must-Use Plugins and Default Themes

Two concepts worth knowing about from day one:

  • Must-use plugins (mu-plugins) — PHP files dropped into wp-content/mu-plugins/ that are automatically activated for every request and can't be deactivated from the admin screen. Hosting companies and agencies use these for site-wide functionality that must never be turned off by accident.
  • Default themes — every WordPress release ships with a bundled theme (for example Twenty Twenty-Four). These are safe fallbacks and good references for coding standards, but production sites almost always use a custom or third-party theme instead.
Next up: Now that WordPress is installed, Directory Structure shows you exactly which files and folders you're allowed to touch.