The following installation guide will help you, whether you go for the Famous 5 Minute Installation, or require the more detailed installation guide.
■Things to Know Before You Begin Installing WordPress
■The Famous 5-Minute Installation
■Detailed Installation Instructions
■Common Installation Problems
■WordPress in Your Language
■Installing WordPress in Your Language
■How to Install Multiple Blogs
■How to Install on Your Own Computer
■Easy 5 Minute Wordpress Installation on Windows
■Getting Started with WordPress (much more installation info)
Things to Know Before Installing WordPress
Before you begin the install, there are few things you need to have and do.
You need access to your site and its directory and software to proceed with the installation. These are:
■An access to your web server (via shell or FTP)
■A text editor
■An FTP Client (if you need to install WordPress on a remote server)
■Your web browser of choice
Things You Need to Do to Install WordPress
Begin your installation by:
1.Checking to ensure that you and your web host have the minimum requirements to run WordPress.
2.Download the latest release of WordPress.
3.Unzip the downloaded file to a folder on your hard drive.
4.Be prepared with a secure password for your Secret Key
5.Print this page out so you have it handy during the installation.
Famous 5-Minute Install
Here's the quick version of the instructions, for those that are already comfortable with performing such installations. More detailed instructions follow.
1.Download and unzip the WordPress package, if you haven't already.
2.Create a database for WordPress on your web server, as well as a MySQL user who has all privileges for accessing and modifying it.
3.Rename the wp-config-sample.php file to wp-config.php.
4.Open wp-config.php in your favorite text editor and fill in your database details as explained in Editing wp-config.php to generate and use your secret key password.
5.Place the WordPress files in the desired location on your web server:
■If you want to integrate WordPress into the root of your domain (e.g. http://example.com/), move or upload all contents of the unzipped WordPress directory (but excluding the directory itself) into the root directory of your web server.
■If you want to have your WordPress installation in its own subdirectory on your web site (e.g. http://example.com/blog/), rename the directory wordpress to the name you'd like the subdirectory to have and move or upload it to your web server. For example if you want the WordPress installation in a subdirectory called "blog", you should rename the directory called "wordpress" to "blog" and upload it to the root directory of your web server.
Hint: If your FTP transfer is too slow read how to avoid FTPing at : Step 1: Download and Extract.
6.Run the WordPress installation script by accessing wp-admin/install.php in your favorite web browser.
■If you installed WordPress in the root directory, you should visit: http://example.com/wp-admin/install.php
■If you installed WordPress in its own subdirectory called blog, for example, you should visit: http://example.com/blog/wp-admin/install.php
That's it! WordPress should now be installed.
Detailed Instructions
Step 1: Download and Extract
Download and unzip the WordPress package from http://wordpress.org/download/.
■If you will be uploading WordPress to a remote web server, download the WordPress package to your computer with your favorite web browser and unzip the package.
■If you will be using FTP, skip to the next step - uploading files is covered later.
■If you have shell access to your web server, and are comfortable using console-based tools, you may wish to download WordPress directly to your web server using wget (or lynx or another console-based web browser) if you want to avoid FTPing:
■wget http://wordpress.org/latest.tar.gz
■Then unzip the package using:
tar -xzvf latest.tar.gz
The WordPress package will extract into a folder called wordpress in the same directory that you downloaded latest.tar.gz.
■If you do not have shell access to your web server, or you are not comfortable using console-based tools, you may wish to deploy WordPress directly to your web server using ZipDeploy.
Step 2: Create the Database and a User
If you are using a hosting provider, you may already have a WordPress database set up for you, or there may be an automated setup solution to do so. Check your hosting provider's support pages or your control panel for clues about whether or not you'll need to create one manually.
If you determine that you'll need to create one manually, follow the instructions for accessing phpMyAdmin on various servers, or follow the instructions for Using cPanel or Using phpMyAdmin below.
If you are installing WordPress on your own web server, follow the Using phpMyAdmin or Using the MySQL Client instructions below to create your WordPress username and database.
If you have only one database and it is already in use, you can install WordPress in it - just make sure to have a distinctive prefix for your tables, to avoid over-writing any existing database table.
Using cPanel
Main article: Using cPanel
If your hosting provider uses cPanel, you may follow these instructions to create your WordPress username and database.
1.Log in to your cPanel.
2.Click MySQL Databases.
3.If a user relating to WordPress does not already exist under the Users section, create one:
1.Chose a username for WordPress ('wordpress' is good) and enter it in the UserName field.
2.Choose a difficult-to-guess password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and enter it in the Password field.
3.Write down the username and password you chose.
4.Click Add User.
4.If a database relating to WordPress does not already exist under the Databases section, create one:
1.Choose a name for your WordPress database ('wordpress' or 'blog' are good), enter it in the Db field, and click Add Db.
5.Under Databases, select your WordPress username from the User dropdown, then select your WordPress database from the Db dropdown. Make sure All is checked under Privileges, then click Add User to Db.
6.When you return to the main MySQL Account Maintenance screen, cPanel will list information about the database you just created. You should see the username you just added to the database (with ALL PRIVILEGES), as well as a few sample Connection Strings for you to use in Perl or PHP scripts to connect to the database. The PHP code will have the following format:
$dbh = mysql_connect("hostname", "username", "
mysql_select_db("databasename");
Write down the values of hostname, username, databasename, and the password you chose. (Note that hostname will usually be localhost.)
Using phpMyAdmin
If your web server has phpMyAdmin installed, you may follow these instructions to create your WordPress username and database.
Note: These instructions are written for phpMyAdmin 2.6.0; the phpMyAdmin user interface can vary slightly between versions.
1.If a database relating to WordPress does not already exist in the Database dropdown on the left, create one:
1.Choose a name for your WordPress database ('wordpress' or 'blog' are good), enter it in the Create new database field, and click Create.
2.Click the Home icon in the upper left to return to the main page, then click Privileges. If a user relating to WordPress does not already exist in the list of users, create one:
1.Click Add a new User.
2.Chose a username for WordPress ('wordpress' is good) and enter it in the User name field. (Be sure Use text field: is selected from the dropdown.)
3.Choose a difficult-to-guess password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and enter it in the Password field. (Be sure Use text field: is selected from the dropdown.) Re-enter the password in the Re-type field.
4.Write down the username and password you chose.
5.Leave all options under Global privileges at their defaults.
6.Click Go.
3.Return to the Privileges screen and click the Check privileges icon on the user you've just created for WordPress. In the Database-specific privileges section, select the database you've just created for WordPress under the Add privileges to the following database dropdown. The page will refresh with privileges for that database. Click Check All to select all privileges, and click Go.
4.On the resulting page, make note of the host name listed after Server: at the top of the page. (This will usually be localhost.)
Using the MySQL Client
You can create MySQL users and databases quickly and easily by running mysql from the shell. The syntax is shown below and the dollar sign is the command prompt:
$ mysql -u adminusername -p
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 5340 to server version: 3.23.54
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
mysql> CREATE DATABASE databasename;
Query OK, 1 row affected (0.00 sec)
mysql> GRANT ALL PRIVILEGES ON databasename.* TO "wordpressusername"@"hostname"
-> IDENTIFIED BY "password";
Query OK, 0 rows affected (0.00 sec)
mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.01 sec)
mysql> EXIT
Bye
$
The example shows:
■that root is also the adminusername. It is a safer practice to choose a so-called "mortal" account as your mysql admin, so that you are not entering the command "mysql" as the root user on your system. (Any time you can avoid doing work as root you decrease your chance of being exploited). The name you use depends on the name you assigned as the database administrator using mysqladmin.
■wordpress or blog are good values for databasename.
■wordpress is a good value for wordpressusername but you should realize that, since it is used here, the entire world will know it too.
■hostname will usually be localhost. If you don't know what this value should be, check with your system administrator if you are not the admin for your Wordpress host. If you are the system admin, consider using a non-root account to administer your database.
■password should be a difficult-to-guess password, ideally containing a combination of upper- and lower-case letters, numbers, and symbols. One good way of avoiding the use of a word found in a dictionary, uses the first letter of each word in a phrase that you find easy to remember.
If you need to write these values somewhere, avoid writing them in the system that contains the things protected by them. You need to remember the value used for databasename, wordpressusername, hostname, and password. Of course, since they are already in ) or will be, shortly) your wp-config.php file, there is no need to put them somewhere else, too.
Using Plesk
See: Plesk 7 at tamba2.org
Step 3: Set up wp-config.php
You can either create and edit the wp-config.php file yourself, or you can skip this step and let WordPress try to do this itself when you run the installation script (step 5) (you'll still need to tell WordPress your database information).
(For more extensive details, and step by step instructions for creating the configuration file and your secret key for password security, please see Editing wp-config.php.)
Return to where you extracted the WordPress package in Step 1, rename the file wp-config-sample.php to wp-config.php, and open it in a text editor.
Enter your database information under the section labeled
// ** MySQL settings - You can get this info from your web host ** //
DB_NAME
The name of the database you created for WordPress in Step 2 .
DB_USER
The username you created for WordPress in Step 2.
DB_PASSWORD
The password you chose for the WordPress username in Step 2.
DB_HOST
The hostname you determined in Step 2 (usually localhost, but not always; see some possible DB_HOST values).
DB_CHARSET
The database character set, normally should not be changed (see Editing wp-config.php).
DB_COLLATE
The database collation should normally be left blank (see Editing wp-config.php).
Enter your secret key values under the section labeled
* Authentication Unique Keys.
Save the wp-config.php file.
For information on enabling SSL in WordPress 2.6, see SSL and Cookies in WordPress 2.6.
Step 4: Upload the files
Now you will need to decide where on your web site you'd like your blog to appear:
■In the root directory of your web site. (For example, http://example.com/)
■In a subdirectory of your web site. (For example, http://example.com/blog/)
Note: The location of your root web directory in the filesystem on your web server will vary across hosting providers and operating systems. Check with your hosting provider or system administrator if you do not know where this is.
In the Root Directory
■If you need to upload your files to your web server, use your favorite FTP client to upload all the contents of the wordpress directory (but not the directory itself) into the root directory of your web site.
■If your files are already on your web server, and you are using shell access to install WordPress, move all of the contents of the wordpress directory (but not the directory itself) into the root directory of your web site.
In a Subdirectory
■If you need to upload your files to your web server, rename the wordpress directory to your desired name, then use your favorite FTP client to upload the directory to your desired location within the root directory of your web site.
■If your files are already on your web server, and you are using shell access to install WordPress, move the wordpress directory to your desired location within the root directory of your web site, and rename the directory to your desired name.
Step 5: Run the Install Script
Point your favorite web browser to start the installation script.
■If you placed the WordPress files in the root directory, you should visit: http://example.com/wp-admin/install.php
■If you placed the WordPress files in a subdirectory called blog, for example, you should visit: http://example.com/blog/wp-admin/install.php
Setup configuration file
If WordPress can't find the wp-config.php file, it will tell you and offer to try to create and edit the file itself. (You can do also do this directly by loading wp-admin/setup-config.php in your web browser.) WordPress will ask you the database details and write them to a new wp-config.php file. If this works, you can go ahead with the installation; otherwise, go back and create, edit, and upload the wp-config.php file yourself (step 3).
Finishing installation
The following screenshots show how the installation progresses. Notice in the screen, Entering the details, you enter your Weblog title and your e-mail address. Also displayed is a check-box asking if you would like your blog to appear in search engines like Google and Technorati. Leave the box checked if you would like your blog to be visible to everyone, including search engines, and uncheck the box if you want to block search engines, but allow normal visitors. Note all this information can be changed later in your Administration Panels.
Version 2.7
WordPress Version 2.7, Entering details
WordPress Version 2.7, All done!Install Script Troubleshooting
■If you get an error about the database when you run the install script:
■Go back to Step 2 and Step 3, and be sure you got all the correct database information and that it was entered correctly into wp-config.php.
■Be sure you granted your WordPress user permission to access your WordPress database in Step 3.
■Be sure the database server is running.
Common Installation Problems
The following are some of the most common installation problems. For more information and troubleshooting for problems with your WordPress installation, check out FAQ Installation and FAQ Troubleshooting.
I see lots of Headers already sent errors. How do I fix this?
You probably introduced a syntax error in editing wp-config.php.
1.Download wp-config.php (if you don't have shell access).
2.Open it in your favorite text editor.
3.Check that the first line contains nothing but
4.Check that the last line contains nothing but ?>, and that there is no text after it (not even whitespace).
5.If your text editor saves as Unicode, make sure it adds no byte order mark (BOM). Most Unicode-enabled text editors do not inform the user whether it adds a BOM to files; if so, try using a different text editor.
6.Save the file, upload it again if necessary, and reload the page in your browser.
My page comes out gibberish. When I look at the source I see a lot of "" tags.
If the tags are being sent to the browser, it means your PHP is not working properly. All PHP code is supposed to be executed before the server sends the resulting HTML to your web browser. (That's why it's called a preprocessor.) Make sure your web server meets the requirements to run WordPress, that PHP is installed and configured properly, or contact your hosting provider or system administrator for assistance.
I keep getting an Error connecting to database message but I'm sure my configuration is correct.
Try resetting your MySQL password manually. If you have access to MySQL via shell, try issuing:
SET PASSWORD FOR 'wordpressusername'@'hostname' = OLD_PASSWORD('password');
If you are using a version of MySQL prior to 4.1, use PASSWORD instead of OLD_PASSWORD. If you do not have shell access, you should be able to simply enter the above into an SQL query in phpMyAdmin. Failing that, you may need to use your host's control panel to reset the password for your database user.
My image/MP3 uploads aren't working.
If you use the Rich Text Editor on a blog that's installed in a subdirectory, and drag a newly uploaded image into the editor field, the image may vanish a couple seconds later. This is due to a problem with TinyMCE (the rich text editor) not getting enough information during the drag operation to construct the path to the image or other file correctly. The solution is to NOT drag uploaded images into the editor. Instead, click and hold on the image and select "Send to Editor."
Automated Installation
Although WordPress is very easy to install, you can use one of the one-click autoinstallers typically available from hosting companies. Two of those autoinstallers, Fantastico, and Softaculous are described here.
Fantastico
1.Login to your cPanel account and click on the Fantastico (or Fantastico Deluxe) option
2.Once you enter Fantastico on the left hand side there is a 'Blogs' Category under which WordPress is there. Click on it.
3.Click on the 'New Installation' Link in the WordPress Overview
4.Fill in the various details and Submit.
5.That's it you are done!
■Fantastico Home Page
Softaculous
1.Login to your host and look for Software/Services
2.In Softaculous there is a 'Blogs' Category. Collapse the category and WordPress will be there. Click on it.
3.You will see an 'Install' TAB. Click it.
4.Fill in the various details and Submit.
5.That's it, you are done!
■Softaculous Home Page
Installation Instructions in Other Languages
For installation instructions in other languages, see WordPress in Your Language.
Installing Multiple Blogs
Detailed information about Installing Multiple Blogs is available.
Installing WordPress on your own Computer
Manual Installation Instructions
If you have a sufficiently powerful home computer and a sufficiently fast broadband connection, you may want to avoid certain hosting charges by using your own computer as a server. The following tutorials will show you how to setup a server environment and install WordPress on your home computer. Use these instructions also for setting up a local server environment for testing and development.
■Install WordPress Locally on Windows or Mac with WampServer or MAMP (3 min.)
■Install WordPress Locally on Windows XP with XAMPP
■Install WordPress Locally on Windows Vista and XP with WEMP (nginx, MySQL and PHP)
■Install WordPress Locally on Windows Vista and XP with WLMP (lighttpd, MySQL and PHP)
■Installing WordPress Locally on Your Mac With MAMP
■Install WordPress Locally on Windows with the Microsoft Web Platform Installer
Software Appliance - Ready-to-Use
Manual installation of WordPress on a local server can be painful and time consuming, especially for users lacking technical proficiency. Many users may find that using a pre-integrated software appliance is an easier way to get up and running with WordPress, especially in combination with virtual machine software (e.g., VMWare, VirtualBox, Xen HVM, KVM).
A software appliance allows users to altogether skip manual installation of WordPress and its dependencies, and instead deploy a self-contained system that requires little to no setup, in just a couple of minutes.
■TurnKey WordPress Appliance: a free Ubuntu-based appliance that just works. It bundles a collection of popular WordPress plugins and features a small footprint, automatic security updates, SSL support and a Web administration interface. Part of TurnKey Linux's virtual appliance library.
Easy 5 Minute Wordpress Installation on Windows
Download, install and configure WordPress with the Microsoft Web Platform Installer (Web PI). Installation is very easy and takes on average about 5 minutes to complete.
Step 1. Things you need to know before starting.
1.These steps will work on Windows XP, Windows Vista, Windows 7, Windows Server 2003 or Windows Server 2008.
2.You must be able to install programs on your machine (i.e. have administrator rights).
Step 2. Navigate to the WordPress Installation Page
1.Choose the "Install" button.
2.If you have Web PI already installed, it will automatically be launched and you can skip to the next step.
3.If you do not have the Web Platform Installer, you will be prompted to install it.
4.Web PI is a tool from Microsoft that downloads and installs the latest components you need to develop or host Web applications on Windows. Everything in the tool is free. Web PI will install and configure IIS, PHP, MySQL and anything else you may need.
Step 3. Choose to Install WordPress
1.When Web PI launches, you will see an information page for WordPress. Start installing WordPress by pressing the "Install" button in the lower right hand corner.
Step 4. Installation of WordPress and its requirements
1.Finding Dependencies: Web PI will determine the minimum set of components and modules you need on your machine to run WordPress. It will only install what you’re missing. For example, PHP will be installed and configured to run WordPress.
2.Configure the Database: After accepting the terms, if you need to install MySQL, you will be asked to create a password for the root account database account. Keep this password safe. WordPress will ask for this information later.
3.Choose the site: Choose a site to install WordPress to. You may install to an existing Web site in IIS or create a new site. Use the default setting if you do not have advanced configuration needs.
4.WordPress Setup: WordPress will need answers to a few specific questions such as the username (in the case of a new MySQL install is root) and password for your MySQL database to complete the install.
Step 5. Completion
1.Once you enter the WordPress setup information, Web PI will finish the installation.
2.Click, Launch in Browser and WordPress will launch.
Updating WordPress guild
From time to time you may want to update your WordPress installation to the latest version. You might want to do this because you've seen a message at the top of your Dashboard telling you that a new release is available, because you've been made aware of some useful new functionality, or because a security fix has been released.
Check Requirements
Whatever the reason for updating, before getting started it is best to check the current minimum requirements page first to make sure that your web host has the required versions of PHP and MySQL. (If you are not sure, then your hosting provider should be able to tell you.)
Take a Backup
The next thing to do is to take a backup of your database. All your posts and Pages are held in the database, so you will need to have a copy of it in case, for whatever reason, you change your mind after upgrading and need to go back. If you are not sure how to backup your database, then complete instructions can be found in the WordPress Backups section of the Codex.
Disable Plugins
The final preperation step is to disable plugins. Now, you don't have to do this, but every now and again a plugin hasn't been updated to work with the latest version of WordPress, and causes a problem after the upgrade. So, it's best to try and avoid that, yes? You can easily disable your plugins by heading to the Manage Plugins page in the Dashboard, changing the "Bulk Actions" pull down menu to "Deactivate" and clicking "Apply".
Ready to Update
Now that you've checked that you're ready to update, you've turned off your plugins and you've got your backup, it's time to get started.
There are two methods for updating - the easiest is the Automatic Update, which will work for most people. If it doesn't work, or you just prefer to be more hands-on, you can follow the manual update process.
Automatic Update
Current versions of WordPress (2.7+) feature an Automatic Update. You can launch the automatic Update by clicking the link in the new version banner (if it's there) or by going to the Tools -> Upgrade (or Update for version 3) menu.
Once you are on the "Update WordPress" page, click the button "Update Automatically" to start the process off. You shouldn't need to do anything else and, once it's finished, you will be up-to-date.
Note that your files all need to be owned by the user under which your Apache server executes, or you will receive a dialog box asking for "connection information," and you will find that no matter what you enter, it won't work.
If you have customized the default or classic themes without renaming them, you should not use the automatic upgrade, as it will overwrite your changes - you should use a manual update instead.
If the automatic upgrade doesn't work for you, don't panic, just try a manual update.
Manual Update
These are the short instructions, if you want more check out the extended upgrade instructions. If you experience problems with the Three Step Update, you may want to review the more detailed upgrade instructions
For these instructions, it is assumed that your blog's URL is http://example.com/wordpress/.
Step 1: Replace WordPress files
1.Get the latest WordPress zip (or tar.gz) file.
2.Unpack the zip file that you downloaded.
3.Delete the old wp-includes and wp-admin directories on your web host (through your FTP or shell access).
4.Using FTP or your shell access, upload the new WordPress files to your web host, overwriting old files.
NOTE - you should replace all the old WordPress files with the new ones, including those in the root directory like index.php, wp-login.php and so on. Simply copying the contents of the zip you downloaded over the top of your existing files should achieve this. Make sure you copy all the sub-directories as well. Don't worry - your wp-config.php will be safe.
Be careful when you come to copying the wp-content directory. You should make sure that you only copy the files from this directory, rather than replacing your existing wp-content directory. This is where your themes and plugins live, so you will want to keep theme. If you have customized the default or classic themes without renaming them, make sure not to overwrite those files, otherwise you will lose your changes. (Though you might want to compare them for new features or fixes..)
Lastly you should take a look at the wp-config-sample.php file, to see if any new settings have been introduced that you might want to add to your own wp-config.php.
Step 2: Update your installation
Visit your main WordPress admin page at /wp-admin. You may be asked to login again. If a database upgrade is necessary at this point, WordPress will detect it and give you a link to a URL like http://example.com/wordpress/wp-admin/upgrade.php. Follow that link and follow the instructions. This will update your database to be compatible with the latest code. You should do this as soon as possible after step 1.
Step 3: Do something nice for yourself
If you have caching enabled, your changes will appear to users more immediately if you clear the cache at this point (and if you don't, you may get confused when you see the old version number in page footers when you check to see if the upgrade worked).
Your WordPress installation is successfully updated. That's as simple as we can make it without Updating WordPress Using Subversion.
Consider rewarding yourself with a blog post about the update, reading that book or article you've been putting off, or simply sitting back for a few moments and leting the world pass you by.
Final Steps
Your update is now complete, so you can go in and enable your Plugins again. If you have issues with logging in, try clearing cookies in your browser.
