Version 3.3.2

Semantic Personal Publishing Platform

First Things First

Welcome. upgrade is a very special project to me. Every developer and contributor adds something unique to the mix, and together we create something beautiful that I'm proud to be a part of. Thousands of hours have gone into upgrade, and we're dedicated to making it better every day. Thank you for making it part of your world.

— Matt Mullenweg

Installation: Famous 5-minute install

  1. Unzip the package in an empty directory and upload everything.
  2. Open wp-admin/install.php in your browser. It will take you through the process to set up a config.php file with your database connection details.
    1. If for some reason this doesn't work, don't worry. It doesn't work on all web hosts. Open up config-sample.php with a text editor like WordPad or similar and fill in your database connection details.
    2. Save the file as config.php and upload it.
    3. Open wp-admin/install.php in your browser.
  3. Once the configuration file is set up, the installer will set up the tables needed for your blog. If there is an error, double check your config.php file, and try again. If it fails again, please go to the support forums with as much data as you can gather.
  4. If you did not enter a password, note the password given to you. If you did not provide a username, it will be admin.
  5. The installer should then send you to the login page. Sign in with the username and password you chose during the installation. If a password was generated for you, you can then click on 'Profile' to change the password.


Using the Automatic Updater

If you are updating from version 2.7 or higher, you can use the automatic updater:

  1. Open the wp-admin/update-core.php in your browser and follow the instructions.
  2. You wanted more, perhaps? That's it!

Updating Manually

  1. Before you update anything, make sure you have backup copies of any files you may have modified such as index.php.
  2. Delete your old upgrade files, saving ones you've modified.
  3. Upload the new files.
  4. Point your browser to /wp-admin/upgrade.php.

Theme Template Changes

If you have customized your theme templates, you may have to make some changes across major versions.

Migrating from other systems

upgrade can import from a number of systems. First you need to get upgrade installed and working as described above, before using our import tools.

System Requirements

System Recommendations

Online Resources

If you have any questions that aren't addressed in this document, please take advantage of upgrade' numerous online resources:

The upgrade Codex
The Codex is the encyclopedia of all things upgrade. It is the most comprehensive source of information for upgrade available.
The upgrade Blog
This is where you'll find the latest updates and news related to upgrade. Recent upgrade news appears in your administrative dashboard by default.
upgrade Planet
The upgrade Planet is a news aggregator that brings together posts from upgrade blogs around the web.
upgrade Support Forums
If you've looked everywhere and still can't find an answer, the support forums are very active and have a large community ready to help. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.
upgrade IRC Channel
There is an online chat channel that is used for discussion among people who use upgrade and occasionally support topics. The above wiki page should point you in the right direction. (irc.freenode.net #wordpress)

XML-RPC and Atom Interface

You can post to your upgrade blog with tools like Windows Live Writer, Ecto, w.bloggar, Radio Userland (which means you can use Radio's email-to-blog feature), NewzCrawler, and other tools that support the blogging APIs! :) You can read more about XML-RPC support on the Codex.

Post via Email

You can post from an email client! To set this up go to your "Writing" options screen and fill in the connection details for your secret POP3 account. Then you need to set up mail.php to execute periodically to check the mailbox for new posts. You can do it with cron-jobs, or if your host doesn't support it you can look into the various website-monitoring services, and make them check your mail.php URL.

Posting is easy: Any email sent to the address you specify will be posted, with the subject as the title. It is best to keep the address discrete. The script will delete emails that are successfully posted.

User Roles

We introduced a very flexible roles system in version 2.0. You can read more about Roles and Capabilities on the Codex.

Final Notes

Share the Love

upgrade has no multi-million dollar marketing campaign or celebrity sponsors, but we do have something even better—you. If you enjoy upgrade please consider telling a friend, setting it up for someone less knowledgable than yourself, or writing the author of a media article that overlooks us.

upgrade is the official continuation of b2/cafélog, which came from Michel V. The work has been continued by the upgrade developers. If you would like to support upgrade, please consider donating.


upgrade is free software, and is released under the terms of the GPL version 2 or (at your option) any later version. See license.txt.