Using TRAL in a container or VM

Vagrant

(Vagrant) is tool for building virtual development environments. TRAL requires a complex ecosystem to use all of its features, so vagrant provides a reproducable environment to test installation.

Installing TRAL within a vagrant box is simple. We assume you have (installed vagrant) and a provider (e.g. VirtualBox). Next, check out the TRAL source code and run

vagrant up

This will download all dependencies and install all external software using the easy setup scripts.

You can then ssh into the box and work with TRAL.

vagrant ssh
$ sudo su
# python3 -c 'import tral; print(tral.__version__)'

Note that the tral data files are downloaded to /root/.tral within the box, so running (within vagrant) as root is recommended. The working directory on the host is mounted as /vagrant within the box for easy data transfer.

Note that external software is licensed independently of TRAL. You should check the licenses for all software. Several tools are restricted to academic use.

Docker

Create a Github.com access token and login your docker instance (more help):

cat ~/TOKEN.txt | docker login ghcr.io -u USERNAME --password-stdin

Get the latest docker image:

sudo docker pull ghcr.io/acg-team/tral/tral_docker:2.0

Fire it up:

sudo docker run -ti ghcr.io/acg-team/tral/tral_docker:2.0

For development check the release procedure.