OJS Installation

OJS Version

Thank you for downloading the Public Knowledge Project's Open Journal Systems. Before proceeding, please read the README file included with this software. For more information about the Public Knowledge Project and its software projects, please visit the PKP web site. If you have bug reports or technical support inquiries about Open Journal Systems, see the support forum or visit PKP's online bug reporting system. Although the support forum is the preferred method of contact, you can also email the team at pkp.contact@gmail.com.


If you are upgrading an existing installation of OJS 2.x, click here to proceed.

Recommended system requirements

  • PHP >= 4.2.0 (including PHP 5.x); you are currently using PHP 5.6.40
  • MySQL >= 4.1 or PostgreSQL >= 7.1 (including PostgreSQL 8.x)
  • Apache >= 1.3.2x or >= 2.0.4x or Microsoft IIS 6
  • Operating system: Any OS that supports the above software, including Linux, BSD, Solaris, Mac OS X, Windows

As PKP does not have the resources to test every possible combination of software versions and platforms, no guarantee of correct operation or support is implied.

Changes to these settings can be made after installation by editing the file config.inc.php in the base OJS directory, or using the site administration web interface.

Supported database systems

OJS has currently only been tested on MySQL and PostgreSQL, although other database management systems supported by ADOdb may work (in full or partially). Compatibility reports and/or code patches for alternative DBMSs can be sent to the OJS team.

Pre-Installation Steps

1. The following files and directories (and their contents) must be made writable:

  • config.inc.php is writable (optional): Yes
  • public/ is writable: Yes
  • cache/ is writable: Yes
  • cache/t_cache/ is writable: Yes
  • cache/t_compile/ is writable: Yes
  • cache/_db is writable: Yes

2. A directory to store uploaded files must be created and made writable (see "File Settings" below).

Locale Settings

For complete Unicode (UTF-8) support, select UTF-8 for all character set settings. Note that this support currently requires a MySQL >= 4.1.1 or PostgreSQL >= 7.1 database server. Please also note that full Unicode support requires PHP >= 4.3.0 compiled with support for the mbstring library (enabled by default in most recent PHP installations). You may experience problems using extended character sets if your server does not meet these requirements.

Your server currently supports mbstring: Yes

The primary language to use for this system. Please consult the OJS documentation if you are interested in support for languages not listed here.


Select any additional languages to support in this system. These languages will be available for use by journals hosted on the site. Additional languages can also be installed at any time from the site administration interface.
* Marked locales may be incomplete.

The encoding to use for data sent to and received from browsers.

The encoding to use for data sent to and received from the database. This should be the same as the client character set. Note that this capability is only supported with MySQL >= 4.1.1 or PostgreSQL >= 7.1. Select "Not applicable" if your database server does not meet these requirements.

The encoding to use for data stored in the database. Note that this capability is only supported with MySQL >= 4.1.1 or PostgreSQL >= 7.1. Select "Not applicable" if your database server does not meet these requirements.

File Settings

Enter full pathname to an existing directory where uploaded files are to be kept. This directory should not be directly web-accessible. Please ensure that this directory exists and is writable prior to installation. Windows path names should use forward slashes, e.g. "C:/myjournal/files".

Your server currently allows file uploads: Yes

Your server currently allows a maximum file upload size of: 32M

Security Settings

SHA1 is recommended if your system supports it (requires PHP >= 4.3.0).

Administrator Account

This user account will become the site administrator and have complete access to the system. Additional user accounts can be created after installation.

Database Settings

OJS requires access to a SQL database to store its data. See the system requirements above for a list of supported databases. In the fields below, provide the settings to be used to connect to the database.

Database drivers listed in brackets do not appear to have the required PHP extension loaded and installation will likely fail if selected.
Any unsupported database drivers listed above are listed solely for academic purposes and are unlikely to work.

Leave the hostname blank to connect using domain sockets instead of over TCP/IP. This is not necessary with MySQL, which will automatically use sockets if "localhost" is entered, but is required with some other database servers such as PostgreSQL.
To use this option your database system must support remote database creation and your user account must have the appropriate permissions to create new databases. If installation fails with this option selected, manually create the database on your server and run the installer again with this option disabled.

OAI Settings

A unique identifier used to identify metadata records indexed from this site using the Open Archives Initiative Protocol for Metadata Harvesting.