Basic Installation

Once you know that the hosting environment is what is required (and the ProcessWire installer will do some additional checks for you), you can proceed with an installation.

Download ProcessWire from the download page on the ProcessWire website. If you wish to use the development version, follow the link to the Github repository. You may want to check in the forums first before leaping for the development version - if in doubt, stick with the master, stable version.

Extract the contents into your web accessible folder. This can either be the root of your website or a sub directory. Assuming you are installing in the root, then your file structure should look something like:

  • /root/
    • site-default/
    • wire/
    • .gitignore
    • COPYRIGHT.txt
    • htaccess.txt
    • index.php
    • install.php
    • LICENCE.txt
    • README.md

Open your web browser and navigate to your website root, or sub-directory if that is where ProcessWire resides.

From the welcome screen, click on the Get Started button.

Step 1: Choose a Profile

Five profiles are available for ProcessWire. For experienced ProcessWire users, the blank profile would be the normal starting point. However, there are four other profiles aimed at those who are new to ProcessWire and wish to learn more. These are the two default profiles, the classic profile and the multi language profile. You can find out more about the default profiles here. Selecting a profile on the installation will give more details about that profile. Click on continue when you have chosen the profile.

Step 2: Check for ProcessWire Compatibility

The initial page will make some checks on the server environment. If everything is green, then you are good to go. If anything shows up as a warning, then see later in this document for troubleshooting advice.

Sometimes you will get a warning to do with the creation of the .htaccess file - click on "recheck" and you may well find that everything is now fine. If you get an internal server error at this point, please check with Nico's trouble shooting guide for common problems - it is normally very easy to fix.

Continue to the next stage of the installation.

Step 3: Configure the database and file permission settings

Enter the database details - the database name, user name and password you created earlier.

Change the Default Time Zone if it is wrong.

Set the file permissions. ProcessWire defaults to the most common permissions of 755 for directories and 644 for files. However you can change these if the host requires different settings - check with your host if in doubt. You can change this later by editing /site/config.php

Setting Host Names - this is not required, but is recommended on production servers. You can change this later by editing /site/config.php

Click on continue and the database will be populated by the default tables.

Step 4: Create Admin Account

Select a name for the admin login URL. This allows you to customize the backend admin location to a unique name for that installation.

You also need to create the main superuser admin account. Since this account has full access to the backend, it should have a very secure password.

Please also choose any directories you need to remove. Normally, you would leave all the unused profiles checked and also remove the installers.

Click on create account to finish the installation. You can now view the front end or login to the admin using the URL set in this last step.

Next: Installing with a third party Profile »


  1. Installation, Moving and Troubleshooting
  2. Pre-installation checks and tasks
  3. Basic Installation
  4. Installing with a third party Profile
  5. Moving a Site
  6. Troubleshooting installations
  7. Host Specific Installation