DEV Community

Koffer.
Koffer.

Posted on

local installation of Open Journal Systems (OJS) with DDEV

Like some know DDEV is an open source tool for launching local web development environments. DDev work by default to install Drupal sites, Wordpress, Typo3 and Laravel (and other cms projects) but OJS is not in the list. OJS is a specialized CMS to publish scientific journals.

To get a local installation this is the steps:
1-Get OJS 3.4 program for the pkp site.
2-Locally create a directory and get there all OJS files, this is the directory where you will run the ddev project.
Actually go inside it using terminal

3- Follow the DDEV instructions to begin with a PHP project

3.1 Write the command: ddev config to begin the project. DDEV will give you the kind of project you can begin with it.
Choose (write) PHP. DDev will ask for another information like project name etc. DDEV begin downloading and creating docker images to run the project.
3.2 Type the command: CD .ddev to go inside the ddev project folder.
Then type the command: nano config.yaml (or vim or the editor you like to use) to change the configuration of project.
3.3 You need to change the php, web server and database the project use, to get the closer you can, to OJS requirements. This is the configuration I use:

name: ojs
type: php
docroot: ""
php_version: "8.0"
webserver_type: apache-fpm
xdebug_enabled: false
additional_hostnames: []
additional_fqdns: []
database:
type: postgres
version: "10"

Check your configuration very carefully before copying this config. The most important part is to get a php 8.0, apache-fpm and postgres 10.

do the change and save configuration file.
Return to main directory (where you copy ojs files)

Dont modify any other information insde conf file.

4- Type the command: ddev start to run DDEV. If all the configuration change are correct you will get a OJS ready to install.
Type the command: ddev launchto open the browser and get the OJS installation page.

5- The OJS installation page will ask for all the information require to install, like a username and a password and database information.
The basic problem I get to install OJS was to get all the requirements needed, many of the version of database OJS ask for are old. I try but cant install the program with mysql, but I get a installation with postgress.
It is important to get database information to not get frustrated. The fast answer is DDEV create a database with name DB a user DB with a password DB and dont write localhost to find the database, type DB, really easy dont? if you want to know more about what DDEV is running just type the command: ddev describe to get all the information of the project.
After all this configuration you will get a OJS site to test local.

Top comments (0)