Run Tercen using Docker.

Setup

Install docker-compose for Linux or Windows or Mac.

Clone the following repository

git clone https://github.com/tercen/tercen_studio.git
cd tercen_studio

Create tercen network

docker network create tercen

Then start tercen ...

docker-compose up -d

Go to http://127.0.0.1:5402 to access Tercen.

Username : admin

Password : admin

Go to http://127.0.0.1:8787/ to access RStudio.

Username : rstudio

Password : tercen

Update

# stop tercen_studio
docker-compose down        
# get tercen_studio latest version           
git pull
docker-compose pull
# start tercen_studio
docker-compose up -d

# check allocated worker threads and memory (see config.yaml for more settings)
docker-compose logs tercen | grep tercen.worker.isolates
docker-compose logs tercen | grep tercen.worker.memory

Uninstall

docker-compose down
# check tercen docker volumes names
docker volume ls
# delete tercen docker volumes
docker volume rm tercen_studio_couchdb3-data
docker volume rm tercen_studio_tercen-data
docker volume rm tercen_studio_tercen-studio-data
docker volume rm tercen_studio_tercen-studio-renv

Build

git tag tercen-studio-r35_3.5.3-1
git push --tags

git tag tercen-studio-r40_4.0.4-7
git push --tags

#docker build -t tercen/tercen-studio-flowsuite docker/tercen-studio-flowsuite
git tag tercen-studio-flowsuite_3.15-6
git push --tags

docker run -it --rm -v /home/alex/dev/tercen/tercen_studio/:/root/mydevfolder tercen/docker_operator bash

Logs

docker-compose logs tercen

Default log level is config(400) , log level configuration can be set in the file ./config/tercen/config.yaml.

# tercen.log.level: '400'
tercen.log.level: '0'

Then restart tercen

# stop tercen_studio
docker compose down        
# start tercen_studio
docker compose up -d
docker compose --version

upgrade from 0.15 to 0.16

Stop tercen.

docker compose down

Update git repository

git pull

Load new tercen docker images.

docker compose pull

Uncomment the following settings in the tercen config file.

config/tercen/config.yaml

tercen.update.task.size: 'true'
tercen.force.upgrade: 'true'
migration.buffer.size: '1000'

Restart tercen.

docker compose up -d

Run the following to track the upgrade process

docker compose logs -f tercen | grep UpgradeProcess16
# check for the following message
# tercen_studio-tercen-1 | Main : 2025-02-21 12:19:36.850358 : 7 : CONFIG : UpgradeProcess16 : do_upgrade done

Once the migration process is completed, following settings must be commented.

#tercen.update.task.size: 'true'
#tercen.force.upgrade: 'true'
#migration.buffer.size: '1000'