ClassicPress Documentation

Installing ClassicPress

In this guide we’ll cover how to set up two main types of ClassicPress sites: installing ClassicPress on a new site, and migrating an existing WordPress site to ClassicPress.

How to do a fresh install of ClassicPressLink to this section

Installing ClassicPress is the first step of your ClassicPress journey. The process in itself will typically take you about five minutes if you are experienced with installing similar web CMS’s. However, should this be your first time installing a CMS on your server, don’t worry. We’ll take you through each of the steps in detail – and if there’s any problem along the way, don’t hesitate to call on the community.

Before you start, you’ll need a few things in order to make the installation process as smooth as possible.  We recommend collecting this information ahead of time.

Server or shared hosting environmentLink to this section

This is a place to store your site’s files and content so that the site is visible to the world.  The hosting environment usually comes with a domain name.

If you don’t have this yet, we recommend taking a look at SiteGround – their basic plan is more than sufficient to run ClassicPress.

You can also install ClassicPress on your local computer.  A site made this way will not be accessible to the public, but it’s great for trying out ClassicPress and its features.  In order to do this, you’ll need to install a web server program like Local by Flywheel.

Program to copy files to the serverLink to this section

If you’re installing ClassicPress on a hosting environment or another remote server, you’ll need to use a program to copy files back and forth.  We recommend getting an SSH account set up with your hosting provider and using this account to copy files via SFTP.  (FTP is also an option, but we do not recommend it because it does not use a secure, encrypted connection to transfer files.)

FileZilla is one program that can copy files to and from almost any server or shared hosting environment.  CyberDuck is another.

MySQL or MariaDB databaseLink to this section

Usually your hosting provider will set this up for you, and you’ll need the database name, username and password for the database.

Installation stepsLink to this section

Once you have all of the above requirements met, you should be able to proceed with the installation.

  1. Download the zip file for ClassicPress from our GitHub releases page (or use this direct link to the 1.0.0-beta1 release).
  2. Unzip the file on your local computer.
  3. Upload the unzipped folder to your server (using either SFTP or FTP).
  4. Create a database for ClassicPress (contact your web host if you aren’t sure how to do this).
  5. Run the ClassicPress Install by going to the domain name associated with your site.
  6. Fill in the required information requested, including the database information set up in Step 4.

Installing with ComposerLink to this section

You can use composer to install ClassicPress v1.0.0-beta1 and recent nightly builds.

This is a good option if you want to automate more steps of the installation process.  For more details, visit the Installing with Composer page.

How to migrate from WordPress to ClassicPressLink to this section

Migrating from WordPress to ClassicPress does not touch your site content (posts, pages, CPTs, themes, plugins, uploads), anything else in your database, wp-config.php, .htaccess, etc.  It only replaces the core WordPress files, most of which are in the wp-admin and wp-includes directories.

To migrate a current WordPress site to ClassicPress, follow these steps:

  1. PLEASE NOTE: ClassicPress is currently in the beta release stage. It is stable, but it is important to take a backup before switching a live production site to ClassicPress. Please also ensure any known conflicting plugins are deactivated (see list below).
  2. Backup the current site — you can do a manual backup in your hosting panel and export the database or you can use some of the recognized backup plugins like BackUpWordPress, iThemes BackupBuddy, or UpdraftPlus to do this.
  3. Download the ClassicPress migration plugin from the plugin’s GitHub releases page (or use this direct link to the plugin’s 0.4.0 release).
  4. Upload the plugin using the WordPress plugins section of your site.
  5. Activate the ClassicPress migration plugin.
  6. Go to the settings of the ClassicPress migration plugin at Tools -> Switch to ClassicPress.
  7. To proceed with the switch it is necessary that all pre-flight checks succeed, with a green check mark.
  8. Press the Switch this site to ClassicPress now! button.
  9. The migration process may take a few minutes depending on your hosting provider, so go grab some water or a beverage of your choice 🙂
  10. When the process is finished, you should see the ClassicPress About screen.  At this point it is safe to delete the “Switch to ClassicPress” plugin.

In the future, the same plugin will allow you to restore your site back to the previous version of WordPress you were using. We would love your help getting this feature implemented. For more information, see the GitHub issue for restoring back to WordPress.

If you have any problems, please join our Slack group and ask in the #support channel.

Migrating to ClassicPress without using the pluginLink to this section


  1. Back up your site files and database.  This is especially important when you are migrating files by hand.
  2. Download the latest ClassicPress zip file from our GitHub releases page.
  3. Unzip the file on your local computer.
  4. On your local computer, remove the wp-config-sample.php file and remove the entire wp-content folder.
  5. Upload what’s left over to your server, replacing the existing files (using either SSH or an application like CyberDuck or FileZilla).
  6. Visit your new ClassicPress site.

Plugin conflictsLink to this section

The following plugins have been reported to conflict with the ClassicPress migration plugin or with ClassicPress itself:

  • WP Config File Editor – reported to conflict with the migration process.
  • Disable WP Core Updates Advance – reported to conflict with the migration process.
  • WordFence – WordFence doesn’t know how to scan ClassicPress core files for changes yet.  After installing ClassicPress, uncheck this option: “Scan Options → General Options → Scan core files against repository versions for changes“.  There will also be a few more errors if you have the “Scan wp-admin and wp-includes for files not bundled with WordPress” option enabled, because ClassicPress has added new files.  Currently this is normal and expected.

Updating ClassicPressLink to this section

For more information about updating ClassicPress to the latest version, see the Updating ClassicPress page.