Skip to content


Switch branches/tags


Docker Image CI

The Digital Methods Initiative Twitter Capture and Analysis Toolset (DMI-TCAT) allows one to retrieve and collect tweets from Twitter and to analyze them in various ways.


You can find detailed installation instructions in the wiki


  • Twitter API credentials (these can be obtained from
  • One of the following Linux distributions:
    • Ubuntu 18.04
    • Debian 9.*
  • ... or Docker (experimental)

Debian and Ubuntu


curl | sudo bash


Our latest Docker images are availble on Docker Hub.

  1. Install Docker Desktop, and start it. Note that on Windows, you may need to ensure that WSL (Windows Subsystem for Linux) integration is enabled in Docker. You can find this in the Docker setting in Settings -> Resources-> WSL Integration -> Enable integration with required distros.

Basic installation

  1. Run the command docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0 and Docker will download version 1.0 (or whatever tag with which you replace the "1.0")
  • --publish HOST_PORT:80 allows you to define which port on the host network is used. If you are using a different port, you may also need to add -e SERVERNAME=localhost:HOST_PORT where HOST_PORT is the desired port as this is used for internal links in the TCAT interface.
  • --volume volume_name:/var/lib/mysql/ ensures you are easily able to reuse your TCAT mysql database and recover data after you are no longer using TCAT
  1. Open the logs to retrieve you login information via either Docker's interface or the command line docker logs tcat (installation may take some time, so you can either wait or run docker logs -f tcat to follow along)
  2. Open http://localhost:80 in your browser and complete the configuration by providing your Twitter API information and which type of tweet capturing you would like to do.
  3. Congratulations! You can use the admin menu to create your first tweet capture bins
  4. In the future, you can stop and start your TCAT container with: docker stop tcat and docker start tcat

Customize for you own server

The Docker installation also allows you to easily host TCAT on a server. In addition to the SERVERNAME environment variable, you can also use Let's Encrypt by adding -e LETSENCRYPT=y and -e You should also open port 443 for Let's Encrypt to work. Your full command might look like this: docker run --publish 80:80 --publish 443:443 --volume tcat_data:/var/lib/mysql/ --detach --name tcat -e -e LETSENCRYPT=y -e digitalmethodsinitiative/tcat:1.0

Further TCAT customization

Finally, if you wish to develop TCAT yourself, you can clone this repository and create your own image.

  1. Clone this repository git clone
  2. Build the image (from the directory where you have cloned TCAT): docker image build --progress=plain -t tcat:1.0 .
  3. Replace digitalmethodsinitiative/tcat:1.0 with tcat:1.0 from above in your docker run command


Please use the issue templates when reporting issues and bugs.


Nice way to describe the fact that we don't have much


We are happy to receive suggestions and improvements.


Apache License Version 2.0


Digital Methods Initiative - Twitter Capture and Analysis Toolset



Code of conduct





No releases published


No packages published