Skip to main content

Connect Application

Prerequisites​

The Connect Application runs either in an external browser (for debugging) or on the emmbeded browser (standalone application). You can only obtain the Connect Application installer from your host institution or the Tera Insights team.

tip

New users are encouraged to use the Connect Application over the browser version because new features are added to it, such as support for external SFTP and a local filesystem bridge to the vault.

caution

The Connect Application does not run on mobile devices or tablets.

Minimum Requirements
  • Processor (CPU): 8 cores.​
  • Memory (RAM): 32 GB.
  • Operating System (OS): MacOS or Windows; RedHat Enterprise 7 or 8, or equivalents like CentOS or Springdale.
  • App Storage: 44.1 MB.
  • Machine Storage: based on intended use.
  • Graphics: based on intended use.​
  • Network: Fiber-optic internet connection.​
  • Supported browsers: Google Chrome or Mozilla Firefox.

Install the Connect Application on macOS​

  1. Open the Connect Application.dmg Installer provided by your institution or the Tera Insights team.
  2. In the prompt, click Continue.
  3. Review the required local machine storage and click Install.
  4. Enter your password when prompted.
  5. In the pop-up, click OK to allow access.
  6. Once the installation is complete, click Close.

Launch the Connect Application on macOS​

  1. Navigate to your apps and open the Connect application.
  2. Launch your deployment to connect to your university’s secure enclave.
  3. In the new prompt, log in to the system.

Install the Connect Application on Windows​

  1. Open the Connect Application.exe Installer provided by your institution or the Tera Insights team.
  2. In the prompt, click Next.
  3. Click I Agree.
  4. Review the required local machine storage for the application, then click Next.
  5. Select Start menu folder and click Install.
  6. Once the installation is complete, click Finish.

Launch the Connect Application on Windows​

  1. Navigate to your Start menu, find and open Connect application.
  2. Launch your deployment to connect to your university’s secure enclave.
  3. In the new prompt, log in to the system.

Install the Connect Application on Linux Fedora Version 40+​

  1. Open Fedora terminal.
  2. Run dnf install _url_to_rpm_.

Install the Connect Application on Linux Ubuntu Version 24+​

  1. Open Ubuntu terminal.
  2. Run wget _url_to_deb_.
  3. Then run dpkg -i local_downloaded_file.
note

The Connect Application does not run on other versions of Linux besides the ones mentioned above.

Manually Add a New Front-End Version​

  1. Open the Connect Application from your desktop.
  2. In the window, click the Manage versions button in the top right (MacOS)/left (Windows) corner.
  3. In the pop-up, click the Add version button in the top right.
  4. Click Upload szip. file to manually upload the new version.
  5. In the window, select the new version file, then click Open.
info

You may also paste the new version file link into the Paste a version URL field.

Manage Front-End Versions​

  1. Open the Connect Application from your desktop.
  2. In the window, click the Manage versions button in the top right (MacOS)/left (Windows) corner.
  3. In the pop-up, select the appropriate front-end version.
  4. Click outside the pop-up to exit.
note

We recommend users always run the latest version, which is selected by default. Front-end versions are updated globally by default.

Delete Front-End Versions​

  1. Open the Connect Application from your desktop.
  2. In the window, click the Manage versions button in the top right (MacOS)/left (Windows) corner.
  3. In the pop-up, click the Delete button next to the front-end version you want to delete.
  4. Click outside the pop-up to exit.

Add a New Deployment​

  1. Open the Connect Application from your desktop.
  2. In the window, click the Add deployment button in the top right (MacOS)/left (Windows) corner.
  3. In the pop-up, click Upload dep. file to upload the deployment.
  4. In the window, select the deployment file, then click Open.
info

You may also paste the deployment file link in the Paste a deployment URL field.

Delete an Existing Deployment​

  1. Open the Connect Application from your desktop.
  2. In the window, click the Delete a deployment button in the top right (MacOS)/left (Windows) corner.
  3. In the prompt, click Yes.
note

Deleting a deployment requires you to re-add it to regain access.

info

You may delete a deployment when there are at least two existing deployments.

Deployment File Requirements for Connect Application Updates​

The same .dep file is required for any new version of Connect Application, as it uses the same database.

If the .dep file is already loaded, the Connect Application will recognize it automatically.