How can I install/upgrade OrangeHRM if I’m facing issues with the web installer/upgrader?

You may be facing issues with the web installer due to your specific server configuration causing timeouts during the installation/upgrade.

If you are having trouble, you can try using our built-in command line installation tool.

First, open your preferred terminal and navigate to your OrangeHRM directory (if you are using XAMPP, open the “Shell” from the XAMPP Control Panel).

cd orangehrm-5.6.1

Verify that the command line tool is working by running this command:

php installer/console

If you are installing OrangeHRM for the first time, you can choose between installing on a new database (i.e. the installer will create a database), or installing on an existing empty database.

To install on a new database run the following command:

php installer/console install:on-new-database

To install on an existing empty database:

php installer/console install:on-existing-database

If you are upgrading an existing installation, make a copy of your database and use it to upgrade. Do not use your main database because it will be unrecoverable in the event of an upgrade error.

Once you have done that, run the following command:

php installer/console upgrade:run

After running one of the commands above, you can follow the prompts given in the command line and provide the requested information.

If this doesn’t help you either, please email us at ossupport@orangehrm.com and attach your log to the email. (See: Where are my log files?)