System requirements

Update Ubuntu

To ensure that all of your modules install correctly, be sure to run the following command before installing any additional modules:

apt-get update

Enable mod_rewrite

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 htaccess

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:

/etc/apache2/sites-available/default

Open it in either vim or nano. Look for the following section (it starts with Directory /var/www):

Enable GD

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

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 including password recovery and contact forms.

If your database was accessed successfully and the permissions applied to your files and directories, the following page should show all green.

On this page you can also select which admin theme you would like to use and what you would like your login URL to be. The default is http://yourdomain.com/processwire.

Choose your username and password

At this time, you also have the chance to create a username and password. The default username is admin but it is advised to use a username other than the default. Your password must be at least 6 characters long.

Finishing Up

If everything has been done correctly, the next screen should give you some information about what ProcessWire did to secure your installation.

Remove the installation script:

rm install.php

Remove the installation files:

rm -r /var/www/site/install/

Make the config file read only:

chmod 444 /var/www/html/site/config.php

At this point, you can view your installation or login to your website!

Further reading

If you have any questions about ProcessWire, you can reach out to the friendly ProcessWire community in the forums.