When an iTDS update has been released you may follow these instructions to update your iTDS.
1. Create a Backup
Choose the guide that matches your current version:
2. Update Paths
2.1 Virtual‑Machine Deployments
SSH into the VM (default creds maltego / tasx
) and then continue with the Docker steps below.
2.2 Docker‑Compose Deployments (online)
2.3 Docker‑Compose Deployments (offline)
Use a host with Internet connectivity to pull the images, save them to tar files, then copy and load them on the isolated host.
3. Updating iTDS to 4.5.x
The iTDS 4.5.x supports SQLite as the default database, so before updating you will need to create a backup of your current server before updating.
Please note that MySQL is considered legacy and user are strongly encouraged to migrate to SQLite.
If you still wish to continue using MySQL, please refer to MySQL legacy support.
The iTDS MySQL to SQLite data migration follows these high-level steps:
- Create a backup of the existing iTDS
- Update the existing iTDS
- Activate license
- Restore the backup on the new iTDS
3.1 Create a backup of the existing iTDS
(Use the backup guides listed above)
3.2 Update the existing iTDS
Run the Docker commands below as root, either by using sudo
, or by running them from a root shell.
Login to Docker registry
Stop your iTDS
Replace the compose file and pull new images
Start your updated iTDS
3.3 Activate server
Navigate to https://<server_ip>:8000/itds/activate
to access the activation UI.
From the activation page under Upload License Certificate, click Choose File and upload your .pfx
license. Click Submit to activate your server.
3.4 Restore the backup on the new iTDS
With the backup file created on the old server, import it onto your new server.
- On the new server, open the Backup and Restore page in the admin interface (
https://<server_ip>:8000/itds/backup
). - Under Restore Backup, select the ZIP exported from the old server.
- Click Restore Backup.