Migrating to a new iTDS Server

Modified on: Fri, 17 Mar, 2023 at 3:29 PM

IMPORTANT!! There is currently a known issue with certain update paths and we are actively working to release a fix. Until then, iTDS docker images will not be available.

Thank you for your patience and understanding.

Migrating from VM to the new dockerized iTDS server usually involves the following steps. These steps can also be used to migrate data from one iTDS instance to another.

  1. Deploy the new server
  2. Create a backup on the old server
  3. Restore the backup on the new server
  4. Update the Seed URL in the Maltego client to point to the new server

Warning: Please ensure that the new server instance has successfully been restored before deleting the old server VM.

1. Deploy the new server

You will need to deploy and activate the new server in your environment so that you can begin the migration to the new server.

Instructions for deploying and then activating our servers are provided here.

2. Create a Backup

The iTDS includes the functionality to create a full backup of the server.

The backup will include all server information, including paired configs uploaded to the server.

To access the backup menu, open the iTDS admin interface (https://<server ip>/iTDS).

From the main interface page, you can then click on the "Backups/Restore" link.


From the backup page, you will have the option to set a password for the backup. After clicking "Create Backup", a backup file will be downloaded in your browser with the contents of your server.


3. Restore the Backup

With the backup file created on the old server, we now want to import the backup onto our new sever.

On the new server, navigate to the Backup/Restore page in the admin interface.

Under the "Backup File" heading, select the file that was exported from the old server.

With the file selected, click "Restore Backup" to restore the information from your old server onto your new server.


4. Update the Seed URL

The Maltego client uses the seed URL to discover transform, entities and machines from the iTDS.

In order to point the Maltego client to the new server, you will need to update the seed URL to point to the new server.

Note: A recent update changed the seed URLs to run on port 443 instead of running on port 8081. This was to avoid issues customers were having connecting to 8081 through their firewall

You can view the latest seed URL of your server seed by navigating to https://<server ip>/iTDS/seeds


To update the seed URL in your Maltego client, go to the home page of the client. Hover your mouse over the hub item that you want to update and click "Details".


A new window will appear that allows you to edit the seed URL used:


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.