Processwire is a free content management system (CMS) and framework (CMF) written in PHP.


For this guide you should be familiar with the basic concepts of


ProcessWire is distributed under the MPL 2.0 license, but also designates some files as using the MIT license.


We’re using PHP in the stable version 8.1:

[isabell@stardust ~]$ uberspace tools version use php 8.1
Selected PHP version 8.1
The new configuration is adapted immediately. Patch updates will be applied automatically.
[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '8.1'
[isabell@stardust ~]$

You will need your database credentials later on:

[isabell@stardust ~]$ my_print_defaults client
[isabell@stardust ~]$

And your blog URL needs to be setup:

[isabell@stardust ~]$ uberspace web domain list
[isabell@stardust ~]$


cd to your document root, then download the latest release and extract it:

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/
[isabell@stardust html]$ wget
--2022-11-18 10:01:53--
2022-11-18 10:01:57 (7.32 MB/s) - 'master.tar.gz' saved [13867981]
[isabell@stardust html]$ tar xfz master.tar.gz
[isabell@stardust html]$ rm master.tar.gz
[isabell@stardust html]$

We’re installing in the document root rather than a subfolder, so move everything from the subfolder up and then remove the subfolder.

[isabell@stardust html]$ mv processwire-master/* .
[isabell@stardust html]$ rm -r processwire-master/
[isabell@stardust html]$


Edit htaccess.txt and comment line Options +FollowSymLinks and uncomment Options +SymLinksIfOwnerMatch.

Then, rename the file so the rules are enforced:

[isabell@stardust html]$ mv htaccess.txt .htaccess


Point your browser to your domain, e.g. This will initiate the ProcessWire installer.

You will need to enter the following information:

  • Site Installation Profile: If you want to start with some example data, follow the instructions on adding profiles (e.g. “Default (Beginner Edition)”) before you continue. Else, use “Blank”.

  • your MySQL username and password: you should know your MySQL credentials. If you don’t, start reading again at the top.

  • your database name: we suggest you use an additional database, for example isabell_processwire

  • Admin User: The name, email address and password of the admin user.

Finishing installation

If not changed during the installation, open and login to the backend.

Now that the installation is complete, make yourself familiar with the basics of ProcessWire’s structure, API and read the getting started pages.

Best practices


Make your /config.php file non-writable.

[isabell@stardust html]$ chmod 600 site/config.php



Check the blog regularly to stay informed about the newest version.

Tested with ProcessWire 3.0.200, Uberspace 7.13, PHP 8.1

Written by: Marco Krage <>