Migrating a ProcessWire Website to an Ubuntu VPS
This article covers a version of Ubuntu that is no longer supported. If you are currently operate a server running Ubuntu 12.04, we highly recommend upgrading or migrating to a supported version of Ubuntu:
- Upgrade to Ubuntu 14.04.
- Upgrade from Ubuntu 14.04 to Ubuntu 16.04
- Migrate the server data to a supported version
Reason: Ubuntu 12.04 reached end of life (EOL) on April 28, 2017 and no longer receives security patches or updates. This guide is no longer maintained.
This guide might still be useful as a reference, but may not work on other Ubuntu releases. If available, we strongly recommend using a guide written for the version of Ubuntu you are using. You can use the search functionality at the top of the page to find a more recent version.
You will need a standard LAMP stack to run ProcessWire. When creating your droplet, under Applications, choose LAMP on Ubuntu. A full list of requirements is available here.
To use mod_rewrite, htaccess overrides have to be enabled. You will need to modify the default host configuration file. This can be found at:
Open it in either
nano. Look for the following section (it starts with
<Directory /var/www/> Options Indexes FollowSymLinks MultiViews AllowOverride None Order allow,deny allow from all </Directory>
Where it says
AllowOverride None change it to
ProcessWire requires GD to be installed in order to resize and crop images uploaded through the CMS. To install GD and run it, use the following commands.
apt-get install php5-gd service apache2 restart
ProcessWire requires that the mod_rewrite PHP module be enabled. If you use Digital Ocean’s LAMP Application droplet configuration, it should already be installed and will only need to be enabled. To enable it and restart Apache, run the following commands:
a2enmod rewrite service apache2 restart
Enable sending email
If you wish to have a contact form on your website, you will also need to ensure that sendmail is installed and configured so that you can use features that send email.
apt-get install sendmail sendmailconfig service sendmail restart service apache2 restart
To speed up PHP mail, add the following line to your host file, which can be found at
yourhostnamehere with your host name.
127.0.0.1 localhost localhost.localdomain yourhostnamehere
Check that all modules were installed correctly
Visit your site URL’s PHP Info page to see that all modules have been installed correctly at
http://yourhostname/info.php where you replace
yourhostname with your actual host name.
Once those are there, we are ready to download and install ProcessWire.
Compress the files of your site
Create a compressed archive of your website for faster upload.
Be sure to include a MySQL dump for your website as well.
Don’t forget about your
.htaccess file, which is invisible by default. This file is required.
tar cvf site_name.tar directory/
Uploading your ProcessWire website
Log in to your website by typing the following command in the command prompt:
Go to your public web directory:
Upload the archive of your website to your droplet using secure copy.
Make sure to also upload a copy of your MySQL dump file.
Unarchive your website
Once your website has uploaded, you can extract your website using the following command:
tar xvf website.tar
This may unarchive your website into a folder called
website/. If this is the case, you will need to move all of the contained files back one directory to
/var/www. This can be done with the following commands:
cd website mv * ..
Create a database
Assuming you already have a MySQL username and password created, you will need to login to MySQL and create a database:
mysql -u username -ppassword
Upon successful login, you should see
mysql >. Run the following command to create a new database:
create database dbname;
To verify that a database has been properly created, you can run the following command:
Import your MySQL dump
Now that you have a database, you can import your MySQL dump file to it using the following command:
mysql -u username -ppassword dbname < path/to/mysqldump.sql
Now that you have uploaded your database, you will need to update your
site/config.php file with your new database credentials:
$config->dbHost = 'localhost'; $config->dbName = 'dbname'; $config->dbUser = 'username'; $config->dbPass = 'password'; $config->dbPort = '3306';
Go check out your website. To make sure everything is working properly, visit some of your pages and login to the dashboard.
If you are unable to successfully login, it may be because the
/site/assets/sessions directory doesn’t exist or is not writeable.
You will need to ensure that the
/site/assets folder is writable by the server so that you can upload files and login.
Also be sure to delete your MySQL dump file once your website is working properly.
If you have any questions about ProcessWire, you can try the forums.