Skip to main content
Open Source Only

This documentation is applicable only for IceHrm Open Source.

Upgrading IceHrm

This guide covers how to upgrade your IceHrm installation to the latest version.

The icehrm-update is an npm tool that automates the upgrade process.

Install the Updater​

# Install Node.js if not present
sudo apt install -y nodejs npm

# Install icehrm-update globally
sudo npm install -g icehrm-update

Run the Updater​

# Run from your IceHrm directory
cd /var/www/icehrm
icehrm-update

# Or specify the path directly
icehrm-update /var/www/icehrm

Updater Options​

# Create a backup before updating
icehrm-update --create-backup

# Keep the downloaded zip file after update
icehrm-update --keep-download

# Skip confirmation prompt
icehrm-update --yes

# Show version
icehrm-update --version

Manual Update Process​

If you prefer to update manually or the updater is not available, see the Manual Upgrade guide.

IceHrm Pro Users​

Important Note for IceHrmPro Users

If you are using IceHrm Pro, you may have additional extensions or modules installed. These require special attention during upgrades.

Troubleshooting​

Common Issues​

White screen after update:

  • Check PHP error logs: tail -f /var/log/nginx/icehrm_error.log
  • Verify file permissions
  • Clear all caches

Database migration errors:

  • Restore database backup
  • Check MySQL user permissions
  • Review migration logs

Missing features after update:

  • Clear browser cache
  • Re-run database migrations
  • Check extension compatibility

Getting Help​

If you encounter issues:

  1. Check the IceHrm documentation
  2. Search the GitHub issues
  3. Contact IceHrm support (Pro users)