iTDS 4.5.x (SQLite support) Installation

The iTDS now officially supports SQLite as the default database .

Note: MySQL is now considered a legacy option While still supported for existing installations, we strongly recommend migrating to SQLite for future compatibility and ease of use..

Starting the Server

After you have installed Docker and Docker Compose on your Host machine follow the steps below:

1. Login to the Docker Registry

To download the latest Docker images, you first need to log into our Docker Registry using the following command:

docker login registry.paterva.com

Enter the iTDS Docker Registry username and password as specified in the Delivery document.

2. Copy your Docker Compose YAML File

Your delivery document includes a link to a Docker Compose YAML file (itds.yml) that can be used to deploy iTDS. You will need to either copy the Docker Compose YAML file or directly download it onto the machine that will be running the Docker containers.

Note: It is recommended that you always run the docker-compose commands from the same directory as the docker-compose YAML file. Please copy the docker-compose YAML file to it’s own directory (e.g. /var/maltego/ or /home/maltego/), and run all future commands from this directory.

You can use either of the following commands to download the YAML file directly on to the host machine (you may need write permissions if downloading to a system directory).

wget https://dolores.paterva.com/customers/docker/download_compose/12/ -O itds.yml

Or

curl https://dolores.paterva.com/customers/docker/download_compose/12/ -o itds.yml

(Optional) Environment Variables

The environmental variables mentioned below can be set in your `itds.yml` file.

The `ENCRYPTION_KEY` is what is used to encrypt a user session. It can be set to any random string of at least 20 characters and should not be changed once initially set.

The `TRANSFORM_TIMEOUT_SECONDS` environmental variable can be used to set the maximum number of seconds for transform execution. Default: 120 seconds.

The `CONNECTION_TIMEOUT_SECONDS` environmental variable can be used to set the number of seconds to wait while trying to connect to the transform server (transform url). Use 0 to wait indefinitely. Default: 10 seconds.

3. Start the Server

From the directory containing the Docker Compose YAML file (e.g. /home/maltego/), build and start the server using ‘docker-compose’:

Docker Compose Version: 20.10.15 and above. Reference: https://docs.docker.com/compose/

docker compose -f itds.yml up -d

The iTDS Docker images will be pulled from the Docker Registry. Once the images have been pulled, the containers will start running automatically in Detached mode (-d).

You can now access the iTDS web interface and access the server. For more information, refer to the iTDS Activation article.