Following are detailed instructions for upgrading WordPress to 6.7.1, from versions 1.5.x, 2.0.x, 2.1.x, or 2.2. For an overview of the update process, please refer to the section Quick upgrade above. If you encounter problems, please re-read the intructions and consult common installation problems. It is a good idea to read the complete instructions before starting, especially the notes for special cases at the end. If you're having problems, try the WordPress support forums. For these instructions, it is assumed that your blog's URL is http://example.com/wordpress/
.
Please note that it is important for the success of the upgrade that you follow the instructions carefully and precisely. If you do not (e.g you do not back up your data), you should know who to blame. Also note that your blog is not available for visitors during the upgrading process or may be broken.
Back up your database
All of your WordPress data, such as posts, users or categories are stored in a MySQL database. In case the upgrade process is not successful, you may have to restore this data, which is why you are backing it up now. To do so, either
Refer to backing up your database for a detailed explanation of this process.
Back up WordPress files
To be able to go back to the previously installed version of WordPress, you create a back up of all installed files. To do so, either
http://example.com/wordpress/
) to your local computer, using an FTP program. Your WordPress folder may include a .htaccess file, which may not be shown by your FTP program. Enable the display of hidden files and be sure to download and save this file as well..tar
file directly on the server including the full WordPress folder from your server's Linux shell, e.g. with tar -cvf wordpress-backup.tar /path/to/wordpress-installation-folder
. Move the newly created .tar
-file to a secure location, outside the WordPress folder. You will be deleting contents of this folder later on.Verify your backups
To ensure that the backups made are usable, you should verify their integrity. To do so, either
.tar
file's contents with tar -tf wordpress-backup.tar
and compare it with the WordPress installation folder.In a later step, you will need to copy parts of this backup back to server, so make sure everything is alright.
Some plugins currently installed may not work with the new version you are about to install, so de-activate them during the upgrade. You'll re-activate them later. To de-activate your plugins
http://example.com/wordpress/wp-admin
and browse to the Plugins page.To install the new version of WordPress you will first remove all old files from the server and then copy the new version to the server. Removing of the old files is a security measure to make sure that no files from the old installation are kept on the server.
Remove old WordPress files
Before removing the old WordPress files, once again make sure that you have a valid backup. You will need to copy files from the backup back to your WordPress installation. In case you have made customisations to your WordPress installation, make sure that you are aware what changes you had made. You might later need to re-do these changes to the upgraded WordPress.
To remove the old WordPress files, either
http://example.com/wordpress/
).Verify that the folder is empty.
Copy the new WordPress files to your server
The new WordPress files now need to be copied to your server. The files are available from the WordPress download page. To install the new files, either
.zip
file to your local computer, extract it to a new folder and upload its contents to your server's WordPress installation folder via FTP. Consult uploading WordPress if you need details..tar.gz
file directly to your server, e.g. using wget http://wordpress.org/latest.tar.gz<code>, extract it with <code>tar -xvfz latest.tar.gz
and copy the files to your WordPress folder.Re-add customised files from your backup
Since you had deleted all files, all your customisations are have been removed from the server. You will need to re-add some of the files from the backup into your WordPress folder to re-enable them. Use your FTP program or a Linux shell to do so.
What files exactly you need to re-add depends on your customisations, however here is a list of files valid for most cases. Copy the following files from your backup to your WordPress folder on the server:
/wp-config.php
file, /.htaccess
file (if present)wp-images
folderwp-includes/languages/
folder in case you were using a language file/wp-content
folder, in case you had custom content, plugins, themes or other customisations in this folder. The new WordPress version may include newer versions of these plugins or themes. If this is the case and you had made custom changes to the previous version, consider re-doing them in the newer version's files.After the new files have been added to the server, other upgrades, e.g. to the database, might be necessary. WordPress provides an upgrade program that does the work for you. To run the programm
http://example.com/wordpress/wp-admin/upgrade.php
. If WordPress is installed in the root folder of your server, access the program at http://example.com/wp-admin/upgrade.php
instead..htaccess
To do so
http://example.com/wordpress/wp-admin
and browse to the Plugins page..htaccess
file. See using permalinks for details.You will now check whether the old plugins still work with the upgraded WordPress installation. To do so:
http://example.com/wordpress/wp-admin
and browse to the Plugins page.http://example.com/wordpress/
. If something looks wrong, deactivate the respective plugin and contact the author for an update.Please review these resources to see what's new in the upgraded WordPress
Your WordPress installation is successfully upgraded.