Install ProcessWire CMS on Ubuntu 22.04

This tutorial intends to teach you to Install ProcessWire CMS on Ubuntu 22.04.

ProcessWire is a free open-source content management framework (CMF) and content management system (CMS). The backend is clean and structured so it can be easily operated. This tool gives you all the freedom you need to design your website. It is not as well-known as the CMS giant WordPress or its competitors, Joomla!, Drupal, and TYPO3, but the streamlined software stands out from the bigger competition thanks to its advantages. 

Steps To Install ProcessWire CMS on Ubuntu 22.04

To complete this guide, must log in to your server as a non-root user with sudo privileges and set up a basic firewall. To do this, you can follow our guide on Initial Server Setup with Ubuntu 22.04.

Then, you must have LAMP Stack installed on your server. To do this, you can visit this guide on How To Install LAMP Stack on Ubuntu 22.04.

Also, you need a domain name that is pointed to your server’s IP address.

When you are done with these requirements, follow the steps below to complete this guide.

Install Required Packages For ProcessWire

At this point, you need to install some PHP extensions and required packages by using the command below:

sudo apt install libapache2-mod-php php-common php-mysql php-xml php-xmlrpc php-curl php-gd php-imagick php-cli php-dev php-imap php-mbstring php-opcache php-soap php-zip php-intl unzip wget curl -y

Set up ProcessWire Database User on Ubuntu 22.04

Now you need to log in to your MariaDB shell and create a ProcessWire database user. To do this, run the command below:

sudo mysql -u root -p

From your MariaDB shell, run the command below to create the ProcessWire database:

MariaDB [(none)]> CREATE DATABASE processdb;

Then, use the command below to create the database user:

MariaDB [(none)]> CREATE USER 'processuser'@'localhost' IDENTIFIED BY 'password';

Grant all the privileges to it with the command below:

MariaDB [(none)]> GRANT ALL PRIVILEGES ON processdb.* TO 'processuser'@'localhost';

Flush the privileges and exit from the MariaDB shell:

MariaDB [(none)]> Exit;

Download ProcessWire CMS on Ubuntu 22.04

At this point, you need to visit the ProcessWire CMS Downloads page and use the wget command to download the latest version of ProcessWire. Here we will download it from the GitHub repository.

sudo wget

Extract your downloaded file by using the command below:

sudo unzip

Then, move your extracted file to the Apache web root directory:

sudo mv processwire-master/ /var/www/html/processwire

Next, set the correct permissions and ownership of the ProcessWire directory on Ubuntu 22.04

# sudo chown www-data:www-data -R /var/www/html/processwire/
# sudo chmod -R 755 /var/www/html/processwire/

Configure Apache Virtual Host For ProcessWire CMS

At this point, you need to create the Apache Virtual Host for your ProcessWire. To do this, you can use your favorite text editor, here we use the vi editor:

sudo vi /etc/apache2/sites-available/processwire.conf

Add the following content to the file. Remember to replace the domain name with yours.

<VirtualHost *:80>


DocumentRoot /var/www/html/processwire

<Directory /var/www/html/processwire/>

Options FollowSymLinks
AllowOverride All
Require all granted


ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined


When you are done, save and close the file.

Next, activate the Apache virtual host and rewrite the module using the following commands:

# sudo a2ensite processwire.conf
# sudo a2enmod rewrite

Restart Apache to apply the changes:

sudo systemctl restart apache2

Access ProcessWire Web Interface

At this point, you can continue your ProcessWire installation on Ubuntu 22.04 from the web interface. To do this, you can type your domain name in your web browser:

You will be redirected to the ProcessWire Welcome page. Click Get Started.

ProcessWire Welcome
ProcessWire Welcome

Then, you should see the site installation profile. Select Blank profile and then click Continue.

ProcessWire CMS Site Installation Profile
Site Installation Profile

Next, you will see the Compatibility Check page, click Continue to Next Step.

ProcessWire Compatibility Check
Compatibility Check

At this point, you need to provide your ProcessWire database details on Ubuntu 22.04 like hostname, database name, database username and password, and Timezone. Then, click Continue.

ProcessWire Database Details
Database Details
Time Zone and File Permissions for ProcessWire
Time Zone and File Permissions
ProcessWire CMS Host Names and Debug Mode
Host Names and Debug Mode

Define your admin username, password, and other settings then click Continue

ProcessWire Admin Settings
Admin Settings

Now, click on Login To Admin.

Login To ProcessWire Admin Ubuntu 22.04
Login To Admin

Provide your admin username and password. Then, click Login.

ProcessWire Login Ubuntu 22.04
ProcessWire Login

Finally, you should see the ProcessWire default dashboard.

ProcessWire Dashboard Ubuntu 22.04
ProcessWire Dashboard

You can now use ProcessWire to publish the content on the web. For more information, you can visit the ProcessWire Documentation page.


At this point, you have learned to Install ProcessWire CMS on Ubuntu 22.04.

Hope you enjoy using it. Please Subscribe to us on Facebook and Twitter.

Newsletter Updates

Enter your email address below and subscribe to our newsletter

Stay informed and not overwhelmed, subscribe now!