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.
With the release of iTDS 4.1.1, a TRANSFORM_TIMEOUT
environmental variable was added which can be used to set the Transform timeout. Users can adjust the Transform timeout by setting the TRANSFORM_TIMEOUT
variable in the docker compose file. The default timeout is set to 2 minutes.
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.