Native PHP installation - KL-Psychological-Methodology/ESMira GitHub Wiki

Native PHP installation

Its minimal requirements are:

  • PHP 7.4 or greater (How to install PHP).
  • PHP needs write access in the file system (which it usually has).
  • For an easy setup: Support for .htaccess files (See below for a setup without .htaccess).

[!NOTE] These instructions assume that you want to install ESMira in the root folder of your domain (e.g. https://example.com/). ESMira can also be installed in a sub folder (e.g. https://example.com/thisIsAFolder/subSubFolder) without any additional steps required. Just copy the files to the desired location.

Step 1: Download ESMira

Download the zipped release of ESMira: Direct link

Step 2: Unzip and transfer to your server

Unzip the ESMira-web.zip you just downloaded, and copy all its contents to the web folder of your server. (On most apache web servers this folder would be /var/www/).

If you copied the correct files, the web folder should have at least four folders (named api, backend, frontend and locales) and a bunch of other files.

Step 3: Set the correct file permissions

[!NOTE] Setting the permissions is needed, so ESMira is able to create its config files and is also required so updates can be installed automatically.

Make sure that PHP has write access to all files you just copied. On most UNIX systems (e.g. Linux or macOS) it is sufficient to just change the file owner of all the folders and files that you just copied to www-data. On Windows, this step is probably not needed.

Almost done!

Your server has been installed. Now, you need to set up your admin account. Continue at Complete the setup.

You should also check Optional steps for specific server setups before you finish.