Installing an i-doit update

i-doit should always be running the latest version. Major releases are published every six months, minor releases approximately every four weeks. There are two update paths: via the web interface or via Console (CLI).

Before updating

1. Create a backup — fully back up the database and file system
2. Check system requirements — verify PHP, MariaDB, and Apache versions against the target version
3. Check add-on compatibility — minimum add-on versions for the target version must be met
4. Ensure write permissions — the web server user needs write access to the i-doit directory

Skipping versions

• From version 20 onwards, major versions can be skipped
• Update to v38 requires at least v35 as the starting point
• Versions below v30 must first be updated to v29

Update via web interface

1. Navigate to Administration > [Tenant] Management > i-doit Update (or via the Quicklaunch widget on the Dashboard)
2. The system check verifies the environment — all items should be green/OK
3. Click "Check for a new version" — requires internet connection
4. The update package is downloaded and extracted
5. Select databases — system database and tenants are usually pre-selected
6. Confirm backup and start the update with "Yes, I did a backup! - Start the update"
7. File update — files are updated (if errors occur: check write permissions, see below)
8. Migration — database changes are applied
9. Property Migration — attribute migrations are executed
10. Completion — click "Run i-doit" to return to the application

Update via Console (CLI)

For servers without internet access or for automated updates.

Preparation

Download the update ZIP from the customer portal and transfer it to the server:

mv /path/to/idoit-38-update.zip /var/www/html/i-doit/
cd /var/www/html/i-doit/
unzip idoit-38-update.zip

Confirm overwriting with A (All) when prompted.

Set permissions

Debian/Ubuntu:

cd /var/www/html/i-doit/
sudo chown www-data:www-data -R .
sudo find . -type d -exec chmod 775 {} \;
sudo find . -type f -exec chmod 664 {} \;

Run update

sudo -u www-data php console.php update \
    -u admin -p admin \
    -z /var/www/html/i-doit/idoit-38-update.zip \
    --v 38

Alternatively, start without parameters — the Console will interactively ask for the missing information:

sudo -u www-data php console.php update

After the update

1. Clear browser cache (Ctrl+Shift+R)
2. Clear i-doit cache under Administration > System Tools > Cache
3. Rebuild search index:

sudo -u www-data php console.php search-index -u admin -p admin

1. Update reports under Administration > System Tools > Cache / Database

Common update issues

Known errors and their solutions are documented in a separate article:

Known issues when updating i-doit

Detailed documentation: Installing an update in the Knowledge Base