How can we help?

Search the knowledge base or browse by topic.

Follow

How to deploy VisibleThread 7 on RHEL 8 and RHEL 9

This guide installs VisibleThread 7 on a single RHEL 8 or RHEL 9 server: the VisibleThread API (VTAPI) first, then VisibleThread, then VTRAG for the AI features. On a server at the minimum spec the installs take about 5 minutes.

Before you start

You need:

  • A RHEL 8 or RHEL 9 server with its Red Hat repositories enabled, either through a Red Hat subscription or, on AWS and Azure, through Red Hat Update Infrastructure (RHUI).
  • At least 16 GB RAM, 2 CPU cores and 100 GB disk.
  • Root or sudo access, and ports 22 and 443 open.
  • Your VisibleThread 7 license file. You upload it at the end.

Do not create a visiblethread user first. The package creates it.

If you install as a non-root user, support can provide a sudoers file with the minimum permissions needed to install the packages.

Step 1: Install the VisibleThread API

Download the VTAPI package and check it:

curl -O https://visiblethread.s3.us-east-1.amazonaws.com/public/download/visiblethread-api-1.0.14-1.x86_64.rpm
md5sum visiblethread-api-1.0.14-1.x86_64.rpm

The MD5 should be 372b4625b6b719fe27473e0cf093f4a3.

Install it:

sudo yum install -y ./visiblethread-api-1.0.14-1.x86_64.rpm

This adds the provisioning script at /usr/share/vtapi/setup/provision.sh.

Step 2: Run the provisioning script

The script installs PostgreSQL 16 and Java 17, creates the databases, and starts VTAPI. The defaults suit a single server with a local database, so most installs run it unchanged:

sudo /usr/share/vtapi/setup/provision.sh

Answer y when it asks you to confirm. It ends with Finished provisioning.

The script is a list of steps, and you turn a step off by commenting out its line. These are the defaults:

Step Default What it does
os_check on Checks the operating system
app_check on Stops if VTAPI is already provisioned
db_install on Installs PostgreSQL locally
db_config on Configures the local database
db_remote_config off Uses a remote PostgreSQL instead
java_install on Installs Java 17
fw_config off Opens tcp/8084 in the firewall

Change them only if you need to:

  • Remote PostgreSQL: comment out db_install and db_config, uncomment db_remote_config, and set the connection details in /etc/default/vtapi.env before you run the script. It asks for the database admin credentials.
  • Java 17 already installed: comment out java_install.
  • VTAPI on a different server from VisibleThread: uncomment fw_config.

If something fails, the log is /var/log/vt-api-provision.log.

Step 3: Install VisibleThread

Download the VisibleThread package and check it:

curl -O https://visiblethread.s3.us-east-1.amazonaws.com/public/download/visiblethread-docs-7.4.2-1.x86_64.rpm
md5sum visiblethread-docs-7.4.2-1.x86_64.rpm

The MD5 should be 404563c6b3221e9f34097306da43ff24.

Install it:

sudo yum install -y ./visiblethread-docs-7.4.2-1.x86_64.rpm

The package starts the visiblethread-docs service itself.

Step 4: If fapolicyd is installed, allow Tomcat

Check whether fapolicyd is installed:

sudo systemctl status fapolicyd

If it is not installed, skip this step. If it is, allow the Tomcat directory and restart:

echo "allow perm=any uid=visiblethread : dir=/opt/visiblethread/tomcat/" | sudo tee -a /etc/fapolicyd/rules.d/01-visiblethread.rules
sudo fapolicyd-cli --update
sudo systemctl restart fapolicyd
sudo systemctl restart visiblethread-docs

Step 5: Check the services

sudo systemctl status vtapi
sudo systemctl status visiblethread-docs

Both should show active (running).

Step 6: Install VTRAG

VTRAG powers the AI features that search your documents. Install it on the same server by following How to deploy VTRAG for VisibleThread 7 on RHEL 8 and RHEL 9. VisibleThread is already configured to use VTRAG on the same server, so you only need to install VTRAG and point it at your embeddings model.

Step 7: Complete setup in the browser

Browse to https://<your-server>/. A new server opens the Setup VT Docs Instance page. Every address goes to this page until setup is complete, including the system admin sign-in.

Setup VT Docs Instance page with the license file chosen and the system admin details filled in

  1. Under License File, click Browse and choose your VisibleThread 7 license file.
  2. Enter the System Admin User (an email address), First Name and Last Name.
  3. Enter and confirm a password.
  4. Click Submit. When the confirmation says the instance was created, click OK.

Confirmation dialog: We have created the instance. Close to login

Sign in with the account you just created. A new server opens at System Admin > Workspaces & Users, with a Default Sandbox workspace and the license count from your file.

System Admin page after the first sign-in, showing Workspaces and Users and the Generative AI menu item

Next, connect your LLM under System Admin > Generative AI to turn on the AI features.

Troubleshooting

  • Provisioning failed: check /var/log/vt-api-provision.log.
  • The site does not load after the install: check sudo systemctl status visiblethread-docs, and sudo journalctl -u visiblethread-docs if it is not running.
  • Tomcat will not start and fapolicyd is installed: complete step 4.
Was this article helpful?
0 out of 0 found this helpful

Get Additional Help

Reach out to support@visiblethread.com to create a ticket.